Skip to content

Certificate

Certificate

Endpoints: GET /v1alpha1/issuers/{issuerId}/certificates

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

Referenced By (2): - Get Certificate Response - List Certificates Response

References (4): - Decimal - Iso8601 Complete Calendar Date - Iso8601 Complete Calendar Date Time - Money

Example: 

{
  "id": "34",
  "issuerId": "7",
  "stakeholderId": "4903",
  "shareClassName": "Series Seed Preferred",
  "issueDate": {
    "value": "2013-04-10"
  },
  "quantity": {
    "value": "150000"
  },
  "securityLabel": "PS-2",
  "pricePerShare": {
    "currencyCode": {
      "value": "USD"
    },
    "amount": {
      "value": "0.27"
    }
  },
  "lastModifiedDatetime": {
    "value": "2024-07-30T09:31:57.000000Z"
  }
}

Properties:

Property Type Description Required
canceledDate Iso8601 Complete Calendar Date The date the certificate was canceled. -
canceledQuantity Decimal The number of shares in the certificate that were canceled. -
id STRING The identifier of the certificate.
Constraints: Max length: 50		 -
issueDate Iso8601 Complete Calendar Date The date the certificate was issued. -
issuerId STRING The identifier of the issuer owning the certificate.
Constraints: Min length: 1, Max length: 50		 -
lastModifiedDatetime Iso8601 Complete Calendar Date Time The date and time when the certificate was last modified. -
pricePerShare Money The cost of each share in the certificate. -
quantity Decimal The number of shares in the certificate. -
returnedToPoolQuantity Decimal The number of shares in the certificate that were returned to the pool. -
returnedToTreasuryQuantity Decimal The number of shares in the certificate that were annulled, but not returned to the pool. -
securityLabel STRING The label representing this security (certificate).
Constraints: Max length: 50		 -
shareClassName STRING The name of the share class for the shares held in this certificate.
Constraints: Max length: 100		 -
stakeholderId STRING The identifier of the stakeholder holding the certificate.
Constraints: Max length: 50		 -