Equity plans API reference

An equity plan (internally called a stock plan) defines a pool of shares reserved for equity compensation. Plans are associated with one or more share classes and track how many shares have been reserved versus how many remain available for future grants. You link individual securities — options, RSUs, and similar awards — to a plan when you issue them. Launchboard automatically adjusts currentSharesReserved as grants are issued and cancelled.

Endpoints

Method	Path	Description
`GET`	`/api/v1/equity-plans`	List equity plans (cursor-paginated)
`POST`	`/api/v1/equity-plans`	Create an equity plan
`GET`	`/api/v1/equity-plans/{id}`	Get a single equity plan
`PATCH`	`/api/v1/equity-plans/{id}`	Partially update an equity plan
`DELETE`	`/api/v1/equity-plans/{id}`	Delete an equity plan

List equity plans

Returns a cursor-paginated list of all equity plans for your organization.

curl https://launchboard.xyz/api/v1/equity-plans \
  -H "Authorization: Bearer pg_live_your_key"

Query parameters

number

default:"25"

Maximum results per page. Capped at 100.

string

Opaque cursor from the previous response’s nextCursor field.

Response

object[]

Array of equity plan objects.

Show Equity plan fields

string

UUID of the equity plan.

string

UUID of the owning organization.

string

Plan name (e.g., "2020 Equity Incentive Plan").

string

Plan type label (e.g., "ISO", "NSO", "RSU").

string

Shares reserved at plan adoption, as a decimal string.

string

Current available share pool (adjusted as grants are issued and cancelled), as a decimal string.

string[]

Array of share class UUIDs this plan draws from.

string

Date the plan was adopted, in YYYY-MM-DD format.

string | null

Date the plan expires, in YYYY-MM-DD format.

string | null

Free-text notes.

string

UNVERIFIED or VERIFIED.

string

ISO-8601 timestamp with timezone offset.

string

ISO-8601 timestamp with timezone offset.

string | null

Cursor for the next page. null on the last page.

Create an equity plan

Creates a new equity incentive plan. Supports the Idempotency-Key header for safe retries.

curl -X POST https://launchboard.xyz/api/v1/equity-plans \
  -H "Authorization: Bearer pg_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-2020-plan" \
  -d '{
    "planName": "2020 Equity Incentive Plan",
    "initialSharesReserved": "10000000",
    "stockClassIds": ["sc_common01"],
    "defaultCancellationBehavior": "RETURN_TO_POOL",
    "boardApprovalDate": "2020-06-01",
    "stockholderApprovalDate": "2020-06-15"
  }'

Request body

string

required

Human-readable name for the plan. Maximum 100 characters.

string

required

Number of shares reserved in the pool at adoption, as a positive numeric string.

string[]

default:"[]"

Array of share class UUIDs this plan draws from. Typically a single common stock class.

string

default:"RETURN_TO_POOL"

How cancelled grants are treated: RETURN_TO_POOL (shares revert to the available pool) or RETIRE (shares are permanently retired).

string

Date the board approved the plan, in YYYY-MM-DD format.

string

Date stockholders approved the plan, in YYYY-MM-DD format.

string

Free-text notes. Maximum 2000 characters.

string

UUID of the plan document to associate with this equity plan.

Response

Returns 201 Created with the full equity plan object and a Location header.

Get an equity plan

curl https://launchboard.xyz/api/v1/equity-plans/abc123 \
  -H "Authorization: Bearer pg_live_your_key"

Returns the equity plan object. Field schema is identical to the list response items.

Update an equity plan

Partial update — include only the fields you want to change.

curl -X PATCH https://launchboard.xyz/api/v1/equity-plans/abc123 \
  -H "Authorization: Bearer pg_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "planName": "2020 Equity Incentive Plan (as Amended)",
    "initialSharesReserved": "15000000",
    "comments": "Pool increased by 5M shares per board resolution dated 2024-03-01."
  }'

Request body

All fields from the create request body are accepted; all are optional for PATCH. Returns 200 OK with the updated equity plan object.

Delete an equity plan

curl -X DELETE https://launchboard.xyz/api/v1/equity-plans/abc123 \
  -H "Authorization: Bearer pg_live_your_key"

Returns 204 No Content on success.

Common errors

Status	When it occurs
`400`	Malformed JSON in the request body.
`401`	Missing or invalid `Authorization` header.
`403`	The API key role does not have `EDITOR` permission. Required for `POST`, `PATCH`, and `DELETE`.
`404`	No equity plan with the given `id` exists, or a referenced `stockClassId` does not exist.
`422`	Request body failed schema validation. The response includes a field-level `errors` array.

currentSharesReserved is computed automatically by Launchboard as grants are issued and cancelled. Do not attempt to set it directly — update initialSharesReserved instead to reflect a board-approved pool increase.

Overview

Cap Table

Transactions

Data & Export

Webhooks

Equity plans API reference

Endpoints

List equity plans

Query parameters

Response

Create an equity plan

Request body

Response

Get an equity plan

Update an equity plan

Request body

Delete an equity plan

Common errors

​Endpoints

​List equity plans

​Query parameters

​Response

​Create an equity plan

​Request body

​Response

​Get an equity plan

​Update an equity plan

​Request body

​Delete an equity plan

​Common errors

Endpoints

List equity plans

Query parameters

Response

Create an equity plan

Request body

Response

Get an equity plan

Update an equity plan

Request body

Delete an equity plan

Common errors