Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.launchboard.xyz/llms.txt

Use this file to discover all available pages before exploring further.

The cap table summary endpoint returns a single aggregated snapshot of your organization’s equity state: total shares authorized across all classes, total shares issued, the number of distinct share classes and stakeholders, and the most recent approved valuation. This is the fastest way to populate an ownership dashboard, generate a board-level equity summary, or run a quick sanity check during due diligence — without iterating through every security individually. Share totals are computed directly from live security records (not from denormalized counters), so the numbers you get back always reflect the current state of the ledger.

​
Get the cap table summary

GET /api/v1/cap-table/summary Requires role: VIEWER. No query parameters. 
curl https://launchboard.xyz/api/v1/cap-table/summary \
  -H "Authorization: Bearer pg_live_your_key"
Response — 200 OK 
{
  "data": {
    "orgId": "550e8400-e29b-41d4-a716-446655440000",
    "shareClassCount": 3,
    "stakeholderCount": 12,
    "totalAuthorized": "15000000",
    "totalIssued": "9250000",
    "latestValuation": {
      "id": "550e8400-e29b-41d4-a716-446655440080",
      "type": "409A",
      "pricePerShare": "1.50",
      "effectiveDate": "2024-01-01"
    }
  }
}
​
data.orgId
string (uuid)
Your organization ID.
​
data.shareClassCount
integer
Total number of share classes on your cap table, including classes with zero issued shares.
​
data.stakeholderCount
integer
Total number of stakeholder records in your organization.
​
data.totalAuthorized
string
Sum of currentSharesAuthorized across all share classes that have at least one authorized or issued share. Serialized as a string to preserve precision.
​
data.totalIssued
string
Sum of quantity across all ACTIVE stock securities. Serialized as a string to preserve precision.
​
data.latestValuation
object | null
The most recent valuation with status: "APPROVED", ordered by effectiveDate descending. null if no approved valuation exists.
​
data.latestValuation.id
string (uuid)
Valuation ID. Use GET /api/v1/valuations/{id} for full valuation details.
​
data.latestValuation.type
string
Valuation type (e.g. 409A, FINANCING).
​
data.latestValuation.pricePerShare
string
Per-share value from the most recent approved valuation, serialized as a string.
​
data.latestValuation.effectiveDate
string
Date the valuation took effect (YYYY-MM-DD).

​
Common uses

Ownership dashboard — Poll this endpoint on page load to display headline equity metrics (shares issued, authorized headroom, current 409A price) without fetching individual securities. Investor reporting — Use totalIssued and totalAuthorized to populate the cover page of board materials or investor updates. Due diligence — Cross-check shareClassCount and stakeholderCount against your cap table records during a financing or acquisition process. Reconciliation — Compare totalIssued against the sum of individual security quantities to verify ledger integrity.
For a stakeholder-by-stakeholder or share-class-by-share-class ownership breakdown, use GET /api/v1/securities with the appropriate filters and aggregate in your application, or export the full OCF bundle via GET /api/v1/cap-table/ocf-export.

​
Error codes

StatusWhen it occurs
401Missing or invalid API key.
429Rate limit exceeded. Retry after the interval in the Retry-After header.