Projects

Retrieve all projects

get

/v1/projects

Authorizations

Query parameters

statusstring · enum[]

Array of project statuses

searchstring

Search term for filtering projects by name or other attributes

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.carbonregistry.com/v1/projects' \
  --header 'Authorization: Bearer <token>'

200

200

{
  "projects": [
    {
      "city": "New York",
      "sector": {
        "id": "13",
        "title": "Waste handling and disposal"
      },
      "num": "713",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "otherBenefits": [
        {
          "title": "SDG 13: Climate Action",
          "description": ""
        }
      ],
      "additionalities": [
        {
          "title": "text",
          "description": "text"
        }
      ],
      "fullName": "Project 1",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
      "description": "This is a project",
      "shortDescription": "This is a project",
      "proponents": [
        {
          "fullName": "John Doe",
          "logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "publicUrl": "https://www.carbonregistry.com/explore/organizations/62ffdcad-bd0d-42f7-b8ff-28785a929ed0"
        }
      ],
      "publicUrl": "https://www.carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
      "registry": "ICR",
      "status": "validated",
      "countryCode": "US",
      "state": "New York",
      "startDate": "2023-08-01T00:00:00.000Z",
      "creditingPeriodStartDate": "2023-08-01T00:00:00.000Z",
      "methodology": {
        "id": "VM0034",
        "title": "Canadian Forest Carbon Offset Methodology"
      },
      "type": {
        "id": "removal",
        "title": "Sequestration / Removal",
        "description": "Sequestration, removal and storage of carbondioxide (CO2) from the earth´s atmosphere."
      },
      "estimatedAnnualMitigations": [
        null
      ],
      "location": {
        "lat": 64.10944640131531,
        "lng": -21.81640625
      },
      "kmlFile": {
        "id": "",
        "uri": "http://example.com/document.pdf",
        "type": "monitoringReport",
        "name": "Document 1",
        "isPublic": true
      },
      "validators": [
        {
          "fullName": "John Doe",
          "logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "publicUrl": "https://www.carbonregistry.com/explore/organizations/62ffdcad-bd0d-42f7-b8ff-28785a929ed0"
        }
      ],
      "documentation": [
        {
          "id": "",
          "uri": "http://example.com/document.pdf",
          "type": "monitoringReport",
          "name": "Document 1",
          "isPublic": true
        }
      ]
    }
  ]
}

Retrieve a specific project by Id

get

/v1/projects/{id}

Authorizations

Path parameters

idstringrequired

Project Id

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.carbonregistry.com/v1/projects/{id}' \
  --header 'Authorization: Bearer <token>'

200

200

{
  "project": {
    "city": "New York",
    "sector": {
      "id": "13",
      "title": "Waste handling and disposal"
    },
    "num": "713",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "otherBenefits": [
      {
        "title": "SDG 13: Climate Action",
        "description": ""
      }
    ],
    "additionalities": [
      {
        "title": "text",
        "description": "text"
      }
    ],
    "fullName": "Project 1",
    "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
    "description": "This is a project",
    "shortDescription": "This is a project",
    "proponents": [
      {
        "fullName": "John Doe",
        "logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "publicUrl": "https://www.carbonregistry.com/explore/organizations/62ffdcad-bd0d-42f7-b8ff-28785a929ed0"
      }
    ],
    "publicUrl": "https://www.carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
    "registry": "ICR",
    "status": "validated",
    "countryCode": "US",
    "state": "New York",
    "startDate": "2023-08-01T00:00:00.000Z",
    "creditingPeriodStartDate": "2023-08-01T00:00:00.000Z",
    "methodology": {
      "id": "VM0034",
      "title": "Canadian Forest Carbon Offset Methodology"
    },
    "type": {
      "id": "removal",
      "title": "Sequestration / Removal",
      "description": "Sequestration, removal and storage of carbondioxide (CO2) from the earth´s atmosphere."
    },
    "estimatedAnnualMitigations": [
      null
    ],
    "location": {
      "lat": 64.10944640131531,
      "lng": -21.81640625
    },
    "kmlFile": {
      "id": "",
      "uri": "http://example.com/document.pdf",
      "type": "monitoringReport",
      "name": "Document 1",
      "isPublic": true
    },
    "validators": [
      {
        "fullName": "John Doe",
        "logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "publicUrl": "https://www.carbonregistry.com/explore/organizations/62ffdcad-bd0d-42f7-b8ff-28785a929ed0"
      }
    ],
    "documentation": [
      {
        "id": "",
        "uri": "http://example.com/document.pdf",
        "type": "monitoringReport",
        "name": "Document 1",
        "isPublic": true
      }
    ]
  }
}

Retrieve credits for a specific project

get

/v1/projects/{id}/credits

Authorizations

Path parameters

idstringrequired

Project ID

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.carbonregistry.com/v1/projects/{id}/credits' \
  --header 'Authorization: Bearer <token>'

200

200

{
  "summary": {
    "exPost": 1200,
    "exPostCancelled": 0,
    "exAnte": 15,
    "exAnteCancelled": 0,
    "retired": 13.5,
    "validated": 3500
  },
  "vintages": [
    {
      "events": [
        {
          "id": "text",
          "vintage": "text",
          "createdAt": "2025-03-09T14:04:42.510Z",
          "amount": 1,
          "type": "issuance",
          "creditType": "carbon",
          "monitoringPeriodStart": "2025-03-09T14:04:42.510Z",
          "monitoringPeriodEnd": "2025-03-09T14:04:42.510Z",
          "files": [
            {
              "fileName": "text",
              "id": "text",
              "size": 1024,
              "url": "text",
              "type": "monitoringReport"
            }
          ],
          "verificationBody": {
            "id": "text",
            "directoryUrl": "text",
            "fullName": "text"
          }
        }
      ],
      "vintage": "2023",
      "summary": {
        "exPost": 1200,
        "exPostCancelled": 0,
        "exAnte": 15,
        "exAnteCancelled": 0,
        "retired": 13.5,
        "validated": 3500
      }
    }
  ],
  "project": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "fullName": "Project 1",
    "url": "https://api.carbonregistry.com/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
    "publicUrl": "https://carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
    "num": "713"
  }
}