Endpoints available for access tokens

These are endpoints that need no special permissions, only a valid access token. Can be an app access token or some installation access token.

Who can use these endpoints

You can use any access token to access these endpoints.

Projects

list projects

Get projects

This endpoint returns a paginated list of projects. The projects returned are the ones that are public and have a verified organization.

GEThttps://api.carbonregistry.com/projects

Query parameters

Header parameters

Response

200

Body

application/json

pagination*ApiPaginationDto (object)

projects*array of ApiProjectDto (object)

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/projects', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "pagination": {
    "total": 100,
    "currentPage": 1,
    "pageCount": 10,
    "nextPage": 2,
    "prevPage": 0
  },
  "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",
          "checked": true,
          "id": 12,
          "description": ""
        }
      ],
      "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
      },
      "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": "proofOfConcept",
          "name": "Document 1",
          "isPublic": false
        }
      ]
    }
  ]
}

Returns a paginated list of all public projects on ICR.

Callable by any access token regardless of permissions.

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects?limit=10&page=0' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

list internal projects

Get internal projects - as seen in app

This endpoint returns a paginated list of projects as seen in app - may be non-reviewed data.

GEThttps://api.carbonregistry.com/projects/internal

Query parameters

Header parameters

Response

200

Body

application/json

pagination*ApiPaginationDto (object)

projects*array of ApiProjectDto (object)

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/projects/internal', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "pagination": {
    "total": 100,
    "currentPage": 1,
    "pageCount": 10,
    "nextPage": 2,
    "prevPage": 0
  },
  "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",
          "checked": true,
          "id": 12,
          "description": ""
        }
      ],
      "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
      },
      "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": "proofOfConcept",
          "name": "Document 1",
          "isPublic": false
        }
      ]
    }
  ]
}

Returns a paginated list of all projects on ICR.

Callable by any access token with permissions "examiner:read".

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects/internal?limit=10&page=0' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Get internal project

Get internal project - as seen in app

This endpoint returns the given project as seen in app - may be non-reviewed data.

GEThttps://api.carbonregistry.com/projects/internal/{projectId}

Path parameters

projectId*string

Header parameters

Response

200

Body

application/json

pagination*ApiPaginationDto (object)

projects*array of ApiProjectDto (object)

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/projects/internal/{projectId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "pagination": {
    "total": 100,
    "currentPage": 1,
    "pageCount": 10,
    "nextPage": 2,
    "prevPage": 0
  },
  "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",
          "checked": true,
          "id": 12,
          "description": ""
        }
      ],
      "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
      },
      "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": "proofOfConcept",
          "name": "Document 1",
          "isPublic": false
        }
      ]
    }
  ]
}

Returns the project as seen on ICR.

Callable by any access token with permissions "examiner:read".

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects/internal/:id' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

get project based on credit serialization / creditId

Find a project

This endpoint returns a project if it matches the search params. One can search either by setting the serialization of the project's credit or the creditId. The project is returned in the same format as the /projects endpoint.

GEThttps://api.carbonregistry.com/projects/find/project

Query parameters

Header parameters

Response

200

Body

application/json

citystring

The city of the project

Example: "New York"

sectorall of

The sector of the project

num*number

Project number. This is a unique identifier for the project

Example: "713"

id*string

The ID of the project

Example: "123e4567-e89b-12d3-a456-426614174000"

otherBenefitsarray of ApiOtherBenefitDto (object)

Other benefits of the project

fullName*string

The full name of the project

Example: "Project 1"

thumbnailstring

The url of the thumbnail of the project

Example: "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzKakVt-GHFNrAN9xFd8B26vYVFLyWoUds8w&usqp=CAU"

description*string

The description of the project

Example: "This is a project"

shortDescription*string

The short description of the project

Example: "This is a project"

proponents*array of ApiProponentDto (object)

The proponents of the project

publicUrl*string

The URL of the project

Example: "https://www.carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e"

registry*string

The registry of the project

Example: "ICR"

status*enum

The status of the project

Example: "validated"

draftproject_conceptunder_developmentunder_validationvalidatedclosedretracted

countryCodestring

The ISO 3166-1 alpha-2 country code of the project

Example: "US"

statestring

The state of the project

Example: "New York"

startDate*string (date-time)

The start date of the project

Example: "2023-08-01T00:00:00.000Z"

creditingPeriodStartDate*string (date-time)

The crediting period start date of the project

Example: "2023-08-01T00:00:00.000Z"

methodology*all of

The methodology of the project

type*all of

The type of the project

estimatedAnnualMitigations*array of string

The estimated annual mitigations of the project in tCO2

location*all of

The location of the project

validators*array of ApiProponentDto (object)

The validators of the project

documentation*array of ApiDocumentDto (object)

The documentation of the project

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/projects/find/project', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "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",
      "checked": true,
      "id": 12,
      "description": ""
    }
  ],
  "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
  },
  "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": "proofOfConcept",
      "name": "Document 1",
      "isPublic": false
    }
  ]
}

If you have a creditId or a serialization for a credit you can use this endpoint to get the project that issued the credits.

Callable by any access token regardless of permissions.

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects/find/project?serialization=ICR-ISL-354-78040-14-R-0-2021&creditId=exPost-2-0x51298f2f1142ecb129a2db5e6afd24f34f2e53f1' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

specific project

Get projects

This endpoint returns a paginated list of projects. The projects returned are the ones that are public and have a verified organization.

GEThttps://api.carbonregistry.com/projects/{id}

Path parameters

id*string

Header parameters

Response

200

Body

application/json

pagination*ApiPaginationDto (object)

projects*array of ApiProjectDto (object)

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/projects/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "pagination": {
    "total": 100,
    "currentPage": 1,
    "pageCount": 10,
    "nextPage": 2,
    "prevPage": 0
  },
  "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",
          "checked": true,
          "id": 12,
          "description": ""
        }
      ],
      "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
      },
      "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": "proofOfConcept",
          "name": "Document 1",
          "isPublic": false
        }
      ]
    }
  ]
}

This endpoint returns the project given the projectId.

Callable by any access token regardless of permissions.

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects/{PROJECT_ID}' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

Retirements

List retirements

Callable by any access token regardless of permissions. This endpoint returns all retirements, both on platform and off - if a retirement has not been claimed by a KYBd organization the only data shown is the amount and the project and a pdf can not be generated.

List retirements

This endpoint returns all retirements, both on platform and off - if a retirement has not been claimed by a KYBd organization the only data shown is the amount and the project and a pdf can not be generated.

GEThttps://api.carbonregistry.com/retirements/list

Query parameters

Header parameters

Response

200

Body

application/json

retirements*array of ApiRetirementDto (object)

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/retirements/list', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "retirements": [
    {
      "createdAt": "2024-07-27T08:43:48.306Z",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "isClaimed": false,
      "reason": "Reached retirement age",
      "comment": "Congratulations on your retirement!",
      "beneficiary": "John Doe",
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "organizationOwner": {
        "total": 100,
        "currentPage": 1,
        "pageCount": 10,
        "nextPage": 2,
        "prevPage": 0
      },
      "serialization": "ICR-ISL-354-78040-14-R-0-2021",
      "vintage": "2020",
      "amount": 1000,
      "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"
      }
    }
  ]
}

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/retirements/list' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

Get retirement

Callable by any access token regardless of permissions. This endpoint returns the data connected to a particular retirement.

Get retirement

This endpoint returns a json object with the retirement information.

GEThttps://api.carbonregistry.com/retirements

Query parameters

Header parameters

Response

200

Body

application/json

createdAt*string (date-time)

The date of when this retirement was made

id*string

The ID of the retirement

Example: "123e4567-e89b-12d3-a456-426614174000"

isClaimedboolean

Whether this retirement has been claimed - is false if the retirement happened permissionlessly on blockchain and owner has not claimed the retirement on ICR

reasonstring

The reason for the retirement

Example: "Reached retirement age"

commentstring

A comment about the retirement

Example: "Congratulations on your retirement!"

beneficiarystring

The name of the retiree

Example: "John Doe"

organizationId*string

The ID of the organization associated with the retirement

Example: "123e4567-e89b-12d3-a456-426614174000"

organizationOwnerall of

The organization that owns this credit if it is public information

serializationstring

The serialization of the carbon credits associated with the retirement

Example: "ICR-ISL-354-78040-14-R-0-2021"

vintagestring

The vintage year of the carbon credits associated with the retirement

Example: "2020"

amount*number

The amount of the retirement

Example: 1000

project*all of

The project associated with the carbon credits

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/retirements', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "createdAt": "2024-07-27T08:43:48.306Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isClaimed": false,
  "reason": "Reached retirement age",
  "comment": "Congratulations on your retirement!",
  "beneficiary": "John Doe",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "organizationOwner": {
    "total": 100,
    "currentPage": 1,
    "pageCount": 10,
    "nextPage": 2,
    "prevPage": 0
  },
  "serialization": "ICR-ISL-354-78040-14-R-0-2021",
  "vintage": "2020",
  "amount": 1000,
  "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"
  }
}

Get retirement pdf

Given an id of the retirement this is an endpoint that downloads the certificate.

Callable by any access token regardless of permissions.

Get retirement pdf

This endpoint returns a specificretirement as a pdf

GEThttps://api.carbonregistry.com/retirements/{retirementId}/pdf

Path parameters

retirementId*string

Header parameters

Response

200

File content

Body

application/octet-stream

any

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/retirements/{retirementId}/pdf', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Documents

Get a link to a project document

Given the id of a project document (gotten from one of the project endpoints) you can supply that to this endpoint to get a link where you can download the document.

Get usable document download link

This endpoint returns a link to the document specified.

GEThttps://api.carbonregistry.com/documents/{id}/link

Path parameters

id*string

Response

200

Body

application/json

link*string

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/documents/{id}/link', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "link": "text"
}

Callable by any access token regardless of permissions - unless the document is marked as private then only callable by access token with permissions "examiner:read".

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/projects/{PROJECT_ID}' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

Credit data

Get credit data for a specific project

Given the id of a project this endpoint returns the summary of credit data for all vintages for the project. Callable by any access token regardless of permissions.

Project vintages

Returns a summary of the current state of credits for the given project

GEThttps://api.carbonregistry.com/carbonCredits/projects/{id}

Path parameters

id*string

Response

200

Body

application/json

summary*all of

Summary of project's credit data

vintages*array of ProjectCreditVintageData (object)

The credit data per vintage

project*all of

The project of the reservation

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/carbonCredits/projects/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "summary": {
    "exPost": 1200,
    "exPostCancelled": 0,
    "exAnte": 15,
    "exAnteCancelled": 0,
    "retired": 13.5,
    "validated": 3500
  },
  "vintages": [
    {
      "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"
  }
}

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/carbonCredits/projects/{PROJECT_ID}' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

Get credit data for ICR Buffer Account

This endpoint returns the credit inventory for the ICR buffer account. Callable by any access token regardless of permissions.

ICR Buffer Inventory

Returns the inventory of ICR Buffer Account

GEThttps://api.carbonregistry.com/carbonCredits/icr/inventory/buffer

Response

200

Body

application/json

summary*all of

Summary of project's credit data

organization*all of

The organization

credits*array of ApiInventoryCreditDto (object)

The credits in this organization inventory

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/carbonCredits/icr/inventory/buffer', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "summary": {
    "exPost": 1200,
    "exAnte": 15,
    "retired": 13.5
  },
  "organization": {
    "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"
  },
  "credits": [
    {
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "id": "exPost-2-0x1234567890abcdef",
      "tokenId": "abcdef",
      "tokenAddress": "0x1234567890abcdef",
      "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"
      },
      "serialization": "ICR-ISL-354-78040-14-R-0-2021",
      "vintage": "2020",
      "supply": 1000,
      "unit": "tonne",
      "amount": 100,
      "type": "exAnte"
    }
  ]
}

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/carbonCredits/icr/inventory/buffer' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Typescript

Get credit data for ICR Adjustment Account

This endpoint returns the credit inventory for the ICR adjustment account. Callable by any access token regardless of permissions.

ICR Adjustment Inventory

Returns the inventory of ICR Adjustment account

GEThttps://api.carbonregistry.com/carbonCredits/icr/inventory/adjustment

Response

200

Body

application/json

summary*all of

Summary of project's credit data

organization*all of

The organization

credits*array of ApiInventoryCreditDto (object)

The credits in this organization inventory

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/carbonCredits/icr/inventory/adjustment', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "summary": {
    "exPost": 1200,
    "exAnte": 15,
    "retired": 13.5
  },
  "organization": {
    "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"
  },
  "credits": [
    {
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "id": "exPost-2-0x1234567890abcdef",
      "tokenId": "abcdef",
      "tokenAddress": "0x1234567890abcdef",
      "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"
      },
      "serialization": "ICR-ISL-354-78040-14-R-0-2021",
      "vintage": "2020",
      "supply": 1000,
      "unit": "tonne",
      "amount": 100,
      "type": "exAnte"
    }
  ]
}

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/carbonCredits/icr/inventory/adjustment' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'

Get credit data for ICR Organization Account

This endpoint returns the credit inventory for the ICR organization account. Callable by any access token regardless of permissions.

ICR Adjustment Inventory

Returns the inventory of ICR Organization account

GEThttps://api.carbonregistry.com/carbonCredits/icr/inventory/organization

Response

200

Body

application/json

summary*all of

Summary of project's credit data

organization*all of

The organization

credits*array of ApiInventoryCreditDto (object)

The credits in this organization inventory

Request

JavaScriptCurl

const response = await fetch('https://api.carbonregistry.com/carbonCredits/icr/inventory/organization', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "summary": {
    "exPost": 1200,
    "exAnte": 15,
    "retired": 13.5
  },
  "organization": {
    "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"
  },
  "credits": [
    {
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "id": "exPost-2-0x1234567890abcdef",
      "tokenId": "abcdef",
      "tokenAddress": "0x1234567890abcdef",
      "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"
      },
      "serialization": "ICR-ISL-354-78040-14-R-0-2021",
      "vintage": "2020",
      "supply": 1000,
      "unit": "tonne",
      "amount": 100,
      "type": "exAnte"
    }
  ]
}

cURL

curl -X 'GET' \
  'https://api.carbonregistry.com/carbonCredits/icr/inventory/organization' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"\
  -H 'x-icr-api-version: 2023-06-16'