Dated cap table (version)
Returns a dated cap table version of a company: the register at the effective date (instruments present, shares, quantity, notional) and positions by holder (fund, co-investor line, holding company) with totals by holder. By version_id, or by company_id and as_of (version in force at that date). Quantities only, no fully diluted %. Read-only.
GET
/v1/get_cap_table_versionQuery parameters
version_iduuidoptionalVersion UUID (optional when company_id is given).company_iduuidoptionalCompany UUID (optional when version_id is given).as_ofstringoptionalDate (YYYY-MM-DD, optional; default = today): non-superseded version in force at that date.
Response
Status 200, application/json. Resources outside your rights are absent, never an error.
versionobjectShow child attributes
idstringcompany_idstringeffective_datestringsourcestring · nullablenotestring · nullablesupersedes_idstring · nullablesupersededbooleancreated_atstring · nullable
instrumentsobject[]Show child attributes
instrument_idstring · nullablekindstring · nullablelabelstring · nullableseriesstring · nullablepresentbooleanInstrument present in the register at the effective date.sharesnumber · nullableNumber of shares (share-type instruments).quantitynumber · nullableQuantity (bonds, warrants, ORA…).notional_eurnumber · nullable
positionsobject[]Show child attributes
holderobjectShow child attributes
typeenumOne of:fund,co_investoridstring · nullablefund_id or holder_co_investor_id (co-investor line, no foreign key).labelstring · nullableHolder name frozen in the version.rolestring · nullableFrozen role (hold_co, co_investor, manager…).holding_company_idstring · nullableFrozen holding company, when the line names one.
instrument_idstring · nullablekindstring · nullablelabelstring · nullablequantitynumber
holdersobject[]Show child attributes
holderobjectShow child attributes
typeenumOne of:fund,co_investoridstring · nullablefund_id or holder_co_investor_id (co-investor line, no foreign key).labelstring · nullableHolder name frozen in the version.rolestring · nullableFrozen role (hold_co, co_investor, manager…).holding_company_idstring · nullableFrozen holding company, when the line names one.
quantity_by_kindobjectQuantity held by instrument kind.total_quantitynumber
Errors
400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.