Retirements
Endpoints that return retirement certificates carbonregistry.com has issued
Last updated
Endpoints that return retirement certificates carbonregistry.com has issued
Last updated
Limit the number of results returned
Page number for pagination
curl -L \
--url 'https://api.carbonregistry.com/v1/retirements' \
--header 'Authorization: Bearer <token>'
{
"retirements": [
{
"createdAt": "2025-03-26T01:36:32.010Z",
"id": "123e4567-e89b-12d3-a456-426614174000",
"isClaimed": true,
"reason": "Reached retirement age",
"comment": "Congratulations on your retirement!",
"beneficiary": "John Doe",
"organizationId": "123e4567-e89b-12d3-a456-426614174000",
"organizationOwner": {
"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"
},
"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"
}
}
],
"pagination": {
"total": 100,
"currentPage": 1,
"pageCount": 10,
"nextPage": 2,
"prevPage": 0
}
}
The ID of the retirement
curl -L \
--url 'https://api.carbonregistry.com/v1/retirements/{id}' \
--header 'Authorization: Bearer <token>'
{
"retirement": {
"createdAt": "2025-03-26T01:36:32.010Z",
"id": "123e4567-e89b-12d3-a456-426614174000",
"isClaimed": true,
"reason": "Reached retirement age",
"comment": "Congratulations on your retirement!",
"beneficiary": "John Doe",
"organizationId": "123e4567-e89b-12d3-a456-426614174000",
"organizationOwner": {
"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"
},
"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"
}
}
}
Entity ID
curl -L \
--url 'https://api.carbonregistry.com/v1/{id}/retirements' \
--header 'Authorization: Bearer <token>'
{
"retirements": [
{
"createdAt": "2025-03-26T01:36:32.010Z",
"id": "123e4567-e89b-12d3-a456-426614174000",
"isClaimed": true,
"reason": "Reached retirement age",
"comment": "Congratulations on your retirement!",
"beneficiary": "John Doe",
"organizationId": "123e4567-e89b-12d3-a456-426614174000",
"organizationOwner": {
"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"
},
"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"
}
}
]
}