List securities

Requires an API key with the securities:read scope · How keys work

Query parameters#

• typestring

  Return only securities of this type.

  One ofshareoptionrsarsusafenotewarrantunitprofits_interestphantom

Response 200#

Every security in one response, under data. Drafts and cancelled securities are included; filter on status.

• dataobject[]

  The securities.

  ›Show 24 attributesHide attributes

  • idstring

    Unique id.

  • certificateIdstring

    Certificate or grant id, such as CS-12 or OPT-9.

  • typestring

    Kind of security.

    One ofshareoptionrsarsusafenotewarrantunitprofits_interestphantom

  • statusstring

    Draft securities are not on the cap table until they are published in the app.

    One ofdraftoutstandingcancelledexercisedconvertedtransferredrepurchasedsettledexpired

  • stakeholderIdstring

    The holder.

  • shareClassIdstring | null

    Share class the security is in or converts into.

  • equityPlanIdstring | null

    Equity plan an option, RSA or RSU was granted from.

  • quantitynumber

    Shares or units granted. For a SAFE or note, the principal in US dollars.

  • outstandingnumber

    Quantity still outstanding today, after exercises, cancellations and repurchases.

  • exercisednumber

    Quantity exercised so far.

  • cancellednumber

    Quantity cancelled so far.

  • vestednumber | null

    Quantity vested today. Null for SAFEs and notes.

  • issueDatedate

    Issue or grant date, YYYY-MM-DD.

  • boardApprovalDatedate | null

    Date the board approved it, when on record.

  • pricePerSharenumber | null

    Purchase price per share, in US dollars.

  • exercisePricenumber | null

    Exercise or strike price per share, in US dollars.

  • optionTypestring | null

    Tax type of an option. iso_nso is a grant split at the $100,000 ISO limit.

    One ofisonsoiso_nso

  • expirationDatedate | null

    Date an option or warrant expires.

  • vestingobject | null

    The vesting schedule, when the security has one.

    ›Show 4 attributesHide attributes

    • idstring

      Schedule id.

    • namestring

      Schedule name, such as 4-year monthly, 1-year cliff.

    • descriptionstring

      The schedule in words.

    • commencementDatedate | null

      Vesting start date, YYYY-MM-DD.

  • safeTypestring | null

    Kind of SAFE.

    One ofpost_moneypre_moneymfnuncapped

  • valuationCapnumber | null

    SAFE or note valuation cap, in US dollars.

  • discountPercentnumber | null

    SAFE or note discount, as a percentage such as 20.

  • interestRatenumber | null

    Convertible note interest rate, as a percentage.

  • maturityDatedate | null

    Convertible note maturity date.

curl https://capable.so/api/v1/securities?type=option \
  -H "Authorization: Bearer $CAPABLE_API_KEY"

{
  "data": [
    {
      "id": "sec_7tq0c2n5vz3d",
      "certificateId": "OPT-9",
      "type": "option",
      "status": "outstanding",
      "stakeholderId": "stk_4m8q2xw7ka1p",
      "shareClassId": "cls_common01x9",
      "equityPlanId": "pln_2024plan7b",
      "quantity": 48000,
      "outstanding": 48000,
      "exercised": 0,
      "cancelled": 0,
      "vested": 19000,
      "issueDate": "2025-03-20",
      "boardApprovalDate": "2025-03-18",
      "pricePerShare": null,
      "exercisePrice": 0.42,
      "optionType": "iso",
      "expirationDate": "2035-03-20",
      "vesting": {
        "id": "vst_4y1c_month",
        "name": "4-year monthly, 1-year cliff",
        "description": "25% after 12 months, then 1/48 monthly over the next 36 months",
        "commencementDate": "2025-03-03"
      },
      "safeType": null,
      "valuationCap": null,
      "discountPercent": null,
      "interestRate": null,
      "maturityDate": null
    }
  ]
}

Errors#

Every error has the same shape. See Errors, limits and conventions.