CapableDocs

Search the API docs

Find an endpoint or guide

Get an API key

CompanyGet company totals

Company

Get company totals

Company-wide cap table totals as of today: shares, options, the pool, fully diluted shares and SAFE money.
GET/api/v1/company

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

Response 200

The company's id and its totals as of today.

  • companyIdstring

    The company the key belongs to.

  • asOfdate

    The date the totals are computed for: today.

  • totalsobject

    Company-wide totals as of the date.

    ›Show 10 attributes
    • outstandingSharesnumber

      Issued shares outstanding, every class.

    • optionsnumber

      Options outstanding.

    • rsusnumber

      RSUs outstanding.

    • warrantsnumber

      Warrants outstanding.

    • availablePoolnumber

      Shares still available to grant across equity plans.

    • fullyDilutednumber

      Shares, options, RSUs, warrants and the available pool together.

    • safePrincipalnumber

      Outstanding SAFE investment, in US dollars.

    • notePrincipalnumber

      Outstanding convertible note principal, in US dollars.

    • capitalContributednumber

      Capital paid in for shares and convertibles, in US dollars.

    • stakeholdersWithSecuritiesnumber

      Stakeholders who hold at least one outstanding security.

Example

Request
curl https://capable.so/api/v1/company \
  -H "Authorization: Bearer $CAPABLE_API_KEY"
Response · 200 OK
JSON
{
  "companyId": "org_northwind8k2",
  "asOf": "2026-11-05",
  "totals": {
    "outstandingShares": 9500000,
    "options": 1015000,
    "rsus": 0,
    "warrants": 0,
    "availablePool": 985000,
    "fullyDiluted": 11500000,
    "safePrincipal": 1250000,
    "notePrincipal": 0,
    "capitalContributed": 1252850,
    "stakeholdersWithSecurities": 18
  }
}

Errors

StatusWhen
401 UnauthorizedThe key is missing, invalid or revoked, or its creator lost access.
402 Payment requiredThe company has no active plan in good standing: its trial ended without one, a payment has failed for over 21 days, or its subscription is paused or has ended.
403 ForbiddenThe key does not have the captable:read scope.
429 Too many requestsThe key went over its rate limit. Wait for Retry-After seconds.

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