Skip to main content

Certificates

Certificates in the Registry API represent the current state of active CORCs in the Puro Registry, which have not yet been retired or withdrawn.

Certificates endpoint can be used to fetch current owners of active non-retired CORCs from Puro Registry.

Data schema​

A certificate bundle object contains the following information:

  • certificates: The bundle's Certificate Id, containing it's start and end range.
  • volume: The amount of certificates in the bundle.
  • accountHolderName: The current owner of the bundle.
  • methodologyCode: The methodology used for creating the certificates.
  • productionFacilityCode: The production facility which did the carbon removal.
  • vintage: The year that the emissions removal took place.
  • productionStartDate: The date when production of the certificates started.
  • productionEndDate: The date when production of the certificates ended.
  • creditType: The ID of the credit type of the certificates in the bundle.
  • issuanceId: The issuance ID of the certificate bundle.
  • issuanceDate: The issuance date of the certificate bundle.

Listing Certificates​

To retrieve a list of certificates, you can use the /registry/certificates endpoint with a GET request. This endpoint supports pagination parameters:

  • limit: The maximum number of items to return (default: 100, max: 100)
  • offset: The number of items to skip (default: 0)

Example Requests​

Simple request:​

List certificates
curl -X 'GET' "/registry/certificates" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $BASIC"

Example with pagination:​

List certificates
curl -X 'GET' "/registry/certificates?limit=10&offset=0" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $BASIC"

Response Structure​

The response includes a pagination object with information about the total number of items, the current offset, and the limit applied. The data array contains the list of certificate bundle objects.

{
  "pagination": {
    "total": 50,
    "offset": 0,
    "limit": 10
  },
  "data": [
    {
      "certificates": "PURO_PR_CORC100+_FI_148003_2024_0052850a-1263-4d3f-af6f-a91288df04e3_1-100",
      "volume": 100,
      "accountHolderName": "Biochar Inc.",
      "methodologyCode": "C03000000",
      "productionFacilityCode": "OC4C00",
      "vintage": 2024,
      "productionStartDate": "2024-01-01T00:00:00.000Z",
      "productionEndDate": "2024-12-12T00:00:00.000Z",
      "creditType": "CORC100+",
      "issuanceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "issuanceDate": "2024-01-01T00:00:00.000Z"
    }
    // Additional certificate bundles...
  ]
}

Next Steps​

Now that you understand how to retrieve information about certificates, you can proceed to learn about Methodologies in the Registry API.