Skip to main content

Production Facilities

Production facilities are core entities in the Registry API that represent physical locations where carbon dioxide is removed from the atmosphere using methodologies approved by Puro.earth.

Data schema​

A production facility object contains the following information:

  • code: The unique 6 character alpha-numeric identifier of the production facility.
  • gsrn: The Global Service Relation Number (GSRN) of the facility. Deprecated by the Production Facility codes, but are available for old facilities.
  • name: The name of the production facility.
  • methodologyCode: The code of the methodology used by the facility, such as C01000000. Methodology details can be fetched from the methodologies endpoint.
  • generalRules: Information about the General Rules version applied to the facility.
  • supplierName: The name of the supplier operating the facility.
  • supplierListingUrl: URL to the supplier's listing page on the Puro.earth main site.
  • sdgs: Sustainable Development Goals (SDGs) associated with the facility.
  • country: The country where the facility is located (ISO 3166-1 alpha-2 code).
  • certificationStatus: The status of the facility's certification.
  • creditingPeriod: The start and end dates of the crediting period.

Listing Production Facilities​

To retrieve a list of production facilities, you can use the /registry/production-facilities endpoint with a GET request. This endpoint supports pagination parameters to control the number of results returned:

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

Example Request​

List production facilities
curl -X 'GET' "/registry/production-facilities" \
  -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 production facility objects.

{
  "pagination": {
    "total": 50,
    "offset": 0,
    "limit": 10
  },
  "data": [
    {
      "code": "P51023",
      "gsrn": "643002406801000400",
      "name": "Production facility 1",
      "methodologyCode": "C010000000",
      "generalRules": {
        "version": "General Rules 4.0",
        "url": "https://puro.earth/general-rules"
      },
      "supplierName": "Carbon Removal Inc.",
      "supplierListingUrl": "https://puro.earth/suppliers/carbon-removal-inc",
      "sdgs": [
        {
          "goal": 13,
          "name": "Climate Action"
        }
      ],
      "country": "US",
      "certificationStatus": "CERTIFIED",
      "creditingPeriod": {
        "start": "2024-01-01",
        "end": "2024-12-31"
      }
    }
    // Additional production facilities...
  ]
}

Getting a Specific Production Facility​

To retrieve information about a specific production facility, you can use the /registry/production-facilities/{productionFacilityCode} endpoint with a GET request, where {productionFacilityCode} is the unique code of the production facility, like P51023 in the following example.

Example Request​

Get production facility by code
curl -X 'GET' "/registry/production-facilities/{productionFacilityCode}" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $BASIC"

Response Structure​

The response contains a single production facility object:

{
  "code": "P51023",
  "gsrn": "643002406801000400",
  "name": "Production facility 1",
  "methodologyCode": "C010000000",
  "generalRules": {
    "version": "General Rules 4.0",
    "url": "https://puro.earth/general-rules"
  },
  "supplierName": "Carbon Removal Inc.",
  "supplierListingUrl": "https://puro.earth/suppliers/carbon-removal-inc",
  "sdgs": [
    {
      "goal": 13,
      "name": "Climate Action"
    }
  ],
  "country": "US",
  "certificationStatus": "CERTIFIED",
  "creditingPeriod": {
    "start": "2024-01-01",
    "end": "2024-12-31"
  }
}

Next Steps​

Now that you understand how to retrieve information about production facilities, you can proceed to learn about Transactions in the Registry API.