Hanzo
OpenapiCaptable

Returns the caller org's share certificates, newest first.

Returns the caller org's share certificates, newest first.

GET /v1/captable/shares

Addresshttps://api.hanzo.ai/v1/captable/shares
MethodGET
Operationget_captable_shares
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the caller org's share certificates, newest first. Each row is joined to its holder and its share class, so a certificate names who holds it and what class it is in without a second call.

Request

GET /v1/captable/shares takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200captableSharesok

200 body — 14 fields.

FieldInTypeAlwaysDescription
databodycaptableShare[]Data is every issued share certificate, newest first.
data[].capitalContributionbodynumberCapitalContribution is the cash paid for the certificate, if recorded.
data[].certificateIdbodystringCertificateID is the certificate number, unique within the company.
data[].companyLegendsbodystring[]CompanyLegends are the restrictive legends printed on the certificate.
data[].idbodystringID is the share id.
data[].issueDatebodystringIssueDate is the ISO date the certificate was issued.
data[].pricePerSharebodynumberPricePerShare is the price paid per share, if recorded.
data[].quantitybodyintegerQuantity is how many shares the certificate covers.
data[].shareClassIdbodystringShareClassID is the class the shares belong to.
data[].shareClassNamebodystringShareClassName is that class's name.
data[].shareClassTypebodystringShareClassType is that class's type, COMMON or PREFERRED.
data[].stakeholderIdbodystringStakeholderID is the holder of the certificate.
data[].stakeholderNamebodystringStakeholderName is that holder's name.
data[].statusbodystringStatus is ACTIVE or DRAFT.

Failure carries the platform error shape — see Errors.

Examples

hanzo captable shares list

Captable API · All Hanzo APIs · Interactive reference

How is this guide?

On this page