---
title: "See who owns what"
method: GET
path: "/captable"
tags: ["captable"]
---

# See who owns what

`GET /captable`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/captable`
- Auth: HTTP bearer

The cap table as of a date (today by default): fully diluted and outstanding totals, by holder, by class and by option plan, from confirmed entries unless include_unconfirmed, with SAFEs from the register beside them. Shares are integers; percentages are decimal strings rounded half to even. entries holds the lines waiting for an officer, each with its facts and documents; detail "full" lists every line. include "check" adds the records check before a priced round; "register" adds the SAFE register, every executed SAFE and whether an officer confirmed it.

## Query parameters

- `as_of` string, date
- `include_unconfirmed` boolean
- `detail` 'summary' | 'full'
- `include` 'check' | 'register'

## Response `200`

The result.

- object
  - `as_of` string, date, required
  - `include_unconfirmed` boolean, required
  - `fully_diluted` integer, required
  - `outstanding` integer, required
  - `holders` object[], required
    - `party_id` string, required
    - `name` string, required
    - `shares` integer, required
    - `as_converted` integer, required
    - `options` integer, required
    - `fully_diluted` integer, required
    - `fully_diluted_percent` string, required
    - `outstanding_percent` string, nullable, required
    - `address_missing` boolean, required
  - `classes` object[], required
    - `entry_id` string, required
    - `name` string, required
    - `kind` 'common' | 'preferred', required
    - `authorized` integer, nullable, required
    - `issued` integer, required
    - `as_converted` integer, required
    - `fully_diluted_percent` string, required
    - `outstanding_percent` string, required
  - `plans` object[], required
    - `entry_id` string, required
    - `name` string, required
    - `reserved` integer, required
    - `granted` integer, required
    - `returned` integer, required
    - `outstanding` integer, required
    - `unissued` integer, required
    - `outstanding_percent` string, required
    - `unissued_percent` string, required
  - `unissued` integer, required
  - `unissued_percent` string, required
  - `entries` object[], required
    - `id` string, required
    - `version` integer, required
    - `status` 'unconfirmed' | 'confirmed' | 'void', required
    - `effective_on` string, date, required
    - `summary` string, required
    - `holder` object, nullable, required
      - `party_id` string, required
      - `name` string, required
    - `terms` union, required
      - object
        - `type` 'share_class', required
        - `name` string, required
        - `kind` 'common' | 'preferred', required
        - `authorized` integer, nullable, required
        - `par_value` string, nullable, required
        - `conversion_ratio` string, required
        - `liquidation` string, nullable, required
      - object
        - `type` 'option_plan', required
        - `name` string, required
        - `reserved` integer, required
        - `class_entry_id` string, nullable, required
      - object
        - `type` 'pool_change', required
        - `plan_entry_id` string, required
        - `shares` integer, required
      - object
        - `type` 'stock_issuance', required
        - `class_entry_id` string, required
        - `class_name` string, required
        - `shares` integer, required
        - `price_per_share` string, nullable, required
        - `consideration` 'cash' | 'services' | 'assignment_of_assets', nullable, required
        - `vesting` object, nullable, required
          - `start` string, date, required
          - `months` integer, required
          - `cliff_months` integer, required
        - `security_id` string, nullable, required
      - object
        - `type` 'option_grant', required
        - `plan_entry_id` string, required
        - `plan_name` string, required
        - `options` integer, required
        - `exercise_price` string, required
        - `option_type` 'iso' | 'nso', nullable, required
        - `grant_date` string, date, nullable, required
        - `vesting` object, nullable, required
          - `start` string, date, required
          - `months` integer, required
          - `cliff_months` integer, required
        - `expires_on` string, date, nullable, required
        - `post_termination_months` integer, nullable, required
        - `acceleration` object, nullable, required
          - `text` string, required
          - `page` integer, nullable, required
        - `outstanding` integer, required
        - `vested` integer, required
      - object
        - `type` 'grant_cancellation', required
        - `grant_entry_id` string, required
        - `options` integer, required
        - `kind` 'termination' | 'expiry' | 'other', required
        - `reason` string, required
      - object
        - `type` 'valuation', required
        - `price_per_share` string, required
        - `provider` string, nullable, required
    - `facts` object[], required
      - `key` string, required
      - `text` string, required
      - `source` object, nullable, required
        - `text` string, required
        - `url` string, required
      - `needs_reason` boolean, required
      - `reason` string, nullable, required
    - `documents` object[], required
      - `role` string, required
      - `document_id` string, required
      - `version_id` string, required
      - `title` string, required
      - `sha256` string, required
    - `entered_by_agent` boolean, required
    - `quotes` object[], required
      - `field` string, required
      - `quote` string, required
    - `drafted_by` string, nullable, required
    - `confirmed_by` string, nullable, required
    - `confirmed_at` string, date-time, nullable, required
    - `authorization` 'on_file' | 'not_on_file', nullable, required
  - `unconfirmed` integer, required
  - `holders_without_address` string[], required
  - `safes` object[], required
    - `safe_id` string, required
    - `register_entry_id` string, required
    - `investor` string, required
    - `amount` string, required
    - `form_title` string, required
    - `cap` string, nullable, required
    - `discount_percent` number, nullable, required
    - `mfn` boolean, required
    - `state` string, required
    - `funded` boolean, required
    - `confirmed` boolean, required
    - `at_cap` string, nullable, required
  - `other_securities` object[], required
    - `id` string, required
    - `label` string, required
    - `detail` string, required
  - `coverage` object, required
    - `lines` integer, required
    - `with_documents` integer, required
  - `offsite_failed_on` string, date, nullable, required
  - `check` object, nullable, required
    - `as_of` string, required
    - `summary` string, required
    - `checks` object[], required
      - `key` 'issuance_documents' | 'consideration' | 'election_83b' | 'authorization' | 'valuation_409a' | 'authorized' | 'plan_reserve' | 'register' | 'promised' | 'address' | 'iso_limit' | 'vesting_unparsed' | 'form_d' | 'contractors' | 'annual_report', required
      - `label` string, required
      - `status` 'checked' | 'not_checked', required
      - `note` string, nullable, required
      - `findings` integer, required
    - `facts` object[], required
      - `check` 'issuance_documents' | 'consideration' | 'election_83b' | 'authorization' | 'valuation_409a' | 'authorized' | 'plan_reserve' | 'register' | 'promised' | 'address' | 'iso_limit' | 'vesting_unparsed' | 'form_d' | 'contractors' | 'annual_report', required
      - `text` string, required
      - `gap` boolean, required
      - `source` object, nullable, required
        - `text` string, required
        - `url` string, required
      - `records` object[], required
        - `label` string, required
        - `path` string, required
      - `fix` object, nullable, required
        - `label` string, required
        - `path` string, required
    - `counts` object, required
      - `holders` integer, required
      - `lines` integer, required
      - `documents` integer, required
      - `safes` integer, required
  - `register` object[], nullable, required
    - `id` string, required
    - `safe_id` string, required
    - `round_id` string, required
    - `version` integer, required
    - `status` 'unconfirmed' | 'confirmed' | 'not_on_file' | 'cancelled', required
    - `investor` string, required
    - `amount` string, required
    - `form` 'cap' | 'discount' | 'mfn', required
    - `form_title` string, required
    - `cap` string, nullable, required
    - `discount_percent` number, nullable, required
    - `mfn` boolean, required
    - `side_letters` string[], required
    - `date_of_safe` string, required
    - `executed_at` string, required
    - `funded_on` string, nullable, required
    - `exemption` string, required
    - `country` string, required
    - `document_id` string, nullable, required
    - `envelope_id` string, nullable, required
    - `consent` object, nullable, required
      - `id` string, required
      - `effective_on` string, nullable, required
      - `text` string, required
    - `confirmed_by` string, nullable, required
    - `confirmed_at` string, date-time, nullable, required
    - `warning` string, nullable, required
    - `replaced_by_safe_id` string, nullable, required
    - `history` object[], required
      - `version` integer, required
      - `status` 'unconfirmed' | 'confirmed' | 'not_on_file' | 'cancelled', required
      - `reason` string, nullable, required
      - `by` string, nullable, required
      - `at` string, date-time, required
    - `source` string, required
    - `file_sha256` string, nullable, required
    - `facts` object[], required
      - `label` string, required
      - `detail` string, nullable, required
      - `link` object, nullable, required
        - `text` string, required
        - `url` string, required
  - `promised` object[], required
    - `party_id` string, required
    - `name` string, required
    - `equity` string, required
    - `envelope_id` string, required
    - `letter` string, required
    - `signed_on` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)