Certificate

A certificate is a record of ownership of a company's shares.

OCF Equivalent

Carta's Certificate is a stock certificate (current state). OCF models the creation of a stock position as a StockIssuance transaction; the "certificate" as a concept is the issuance plus any subsequent cancellation/transfer/repurchase.

StockIssuance — issuance tx. Creates the position.

Related:

StockCancellation — cancellation tx
StockTransfer — transfer tx
StockRepurchase — repurchase tx

Endpoints

GET /v1alpha1/issuers/{issuerId}/certificates — list
GET /v1alpha1/issuers/{issuerId}/certificates/{id} — single

Shape at a glance

Quick comparison of field names, types, and required-ness. See the full Carta properties below, or follow the OCF link for full OCF field documentation.

Carta — v1alpha1Certificate

A certificate is a record of ownership of a company's shares.

Property	Type	Req
`id`	string
`issuerId`	string
`stakeholderId`	string
`shareClassName`	string
`issueDate`	`v1alpha1Iso8601CompleteCalendarDate`
`quantity`	`v1alpha1Decimal`
`securityLabel`	string
`pricePerShare`	`v1alpha1Money`
`canceledDate`	`v1alpha1Iso8601CompleteCalendarDate`
`canceledQuantity`	`v1alpha1Decimal`
`returnedToPoolQuantity`	`v1alpha1Decimal`
`returnedToTreasuryQuantity`	`v1alpha1Decimal`
`lastModifiedDatetime`	`v1alpha1Iso8601CompleteCalendarDateTime`

OCF — StockIssuance

Object describing a stock issuance transaction by the issuer and held by a stakeholder

Property	Type	Required
id	`STRING`	`REQUIRED`
comments	[`STRING`]	-
object_type	Constant: `TX_STOCK_ISSUANCE` Defined in schema/enums/ObjectType	`REQUIRED`
date	schema/types/Date	`REQUIRED`
security_id	`STRING`	`REQUIRED`
custom_id	`STRING`	`REQUIRED`
stakeholder_id	`STRING`	`REQUIRED`
board_approval_date	schema/types/Date	-
stockholder_approval_date	schema/types/Date	-
consideration_text	`STRING`	-
security_law_exemptions	[ schema/types/SecurityExemption ]	`REQUIRED`
stock_class_id	`STRING`	`REQUIRED`
stock_plan_id	`STRING`	-
share_numbers_issued	[ schema/types/ShareNumberRange ]	-
share_price	schema/types/Monetary	`REQUIRED`
quantity	schema/types/Numeric	`REQUIRED`
vesting_terms_id	`STRING`	-
vestings	[ schema/types/Vesting ]	-
cost_basis	schema/types/Monetary	-
stock_legend_ids	[`STRING`]	`REQUIRED`
issuance_type	`Enum - Stock Issuance Type` Description: Enumeration of issuance types where we want to draw attention to some unique aspect of a stock issuance (e.g. is it an RSA) ONE OF: • RSA • FOUNDERS_STOCK	-

Properties

Property	Type	Description
`id`	string	The identifier of the certificate.
`issuerId`	string	The identifier of the issuer owning the certificate.
`stakeholderId`	string	The identifier of the stakeholder holding the certificate.
`shareClassName`	string	The name of the share class for the shares held in this certificate.
`issueDate`	`v1alpha1Iso8601CompleteCalendarDate`	The date the certificate was issued.
`quantity`	`v1alpha1Decimal`	The number of shares in the certificate.
`securityLabel`	string	The label representing this security (certificate).
`pricePerShare`	`v1alpha1Money`	The cost of each share in the certificate.
`canceledDate`	`v1alpha1Iso8601CompleteCalendarDate`	The date the certificate was canceled.
`canceledQuantity`	`v1alpha1Decimal`	The number of shares in the certificate that were canceled.
`returnedToPoolQuantity`	`v1alpha1Decimal`	The number of shares in the certificate that were returned to the pool.
`returnedToTreasuryQuantity`	`v1alpha1Decimal`	The number of shares in the certificate that were annulled, but not returned to the pool.
`lastModifiedDatetime`	`v1alpha1Iso8601CompleteCalendarDateTime`	The date and time when the certificate was last modified.

Referenced by

(not embedded in other domain objects)

Underlying schema: v1alpha1Certificate

← Back to Domain Index