Save Equity Compensation and Convertibles

Save options, RSUs, SARs, SAFEs, notes, and other offchain issuances.

These /transactions routes require issuerId, but they only save MongoDB records. They never produce a row in View History.

Inputs

ID	Notes
`issuerId`	Required.
`stakeholder_id`	Required.
`stock_class_id`	Usually needed for equity compensation.
`stock_plan_id`	Usually needed for options (the plan caps the pool).
`vesting_terms_id`	Optional. Reference a record from Save Valuations and Terms.

Equity compensation

POST /transactions/issuance/equity-compensation

Show equity-compensation request

{
    "issuerId": "<YOUR_ISSUER_ID>",
    "data": {
        "stakeholder_id": "<YOUR_STAKEHOLDER_ID>",
        "stock_plan_id": "<YOUR_STOCK_PLAN_ID>",
        "stock_class_id": "<YOUR_STOCK_CLASS_ID>",
        "compensation_type": "OPTION_NSO",
        "quantity": "10000",
        "exercise_price": {
            "amount": "1.00",
            "currency": "USD"
        },
        "expiration_date": "2036-01-01",
        "termination_exercise_windows": [
            {
                "reason": "VOLUNTARY_OTHER",
                "period": 90,
                "period_type": "DAYS"
            }
        ],
        "custom_id": "OPTION-001",
        "security_law_exemptions": [],
        "comments": []
    }
}

Returns: { "equityCompensationIssuance": ... }.

`compensation_type` values

Value	Use for
`OPTION_NSO`	Non-qualified stock options. Requires `exercise_price`.
`OPTION_ISO`	Incentive stock options (US tax-advantaged). Requires `exercise_price`.
`RSU`	Restricted stock units. No `exercise_price`.
`SAR`	Stock appreciation rights. Requires `base_price` instead of `exercise_price`.

Convertible

POST /transactions/issuance/convertible

Show convertible request

{
    "issuerId": "<YOUR_ISSUER_ID>",
    "data": {
        "stakeholder_id": "<YOUR_STAKEHOLDER_ID>",
        "convertible_type": "SAFE",
        "investment_amount": {
            "amount": "250000",
            "currency": "USD"
        },
        "conversion_triggers": [
            {
                "trigger_id": "SAFE-TRIGGER-001",
                "type": "UNSPECIFIED",
                "conversion_right": {
                    "type": "CONVERTIBLE_CONVERSION_RIGHT",
                    "conversion_mechanism": {
                        "type": "SAFE_CONVERSION",
                        "conversion_mfn": false,
                        "conversion_valuation_cap": {
                            "amount": "10000000",
                            "currency": "USD"
                        },
                        "conversion_discount": "0.2"
                    },
                    "converts_to_future_round": true
                }
            }
        ],
        "seniority": 1,
        "custom_id": "SAFE-001",
        "security_law_exemptions": [],
        "comments": []
    }
}

Returns: { "convertibleIssuance": ... }.

`convertible_type` values

Value	Use for
`SAFE`	Simple Agreement for Future Equity.
`NOTE`	Convertible promissory note (interest, maturity).
`OTHER`	Anything that converts but doesn’t fit SAFE or NOTE shape.

Read these records back

Record	Route
Stock plan	`GET /stock-plan/id/:id`
Vesting terms	`GET /vesting-terms/id/:id`
Valuation	`GET /valuation/id/:id`
Equity compensation / convertible	Currently only available via direct database queries.

Do not expect these records in View History — they’re DB-only by design.

Next: Save Valuations and Terms.

Transfer, Cancel, and Reissue Stock Save Valuations and Terms