---
title: "Get retirements for an entity"
method: GET
path: "/v1/{id}/retirements"
tags: ["Entity Endpoints"]
---

# Get retirements for an entity

`GET /v1/{id}/retirements`

## Path parameters

- `id` string, required

## Response `200`

- EntityRetirementCertificatesResponseDto
  - `retirements` ApiRetirementCertificateDto[], required
    - `createdAt` string, date-time, required — The date of when this retirement was made
    - `id` string, required — The ID of the retirement
    - `isClaimed` boolean — Whether this retirement has been claimed - is false if the retirement happened permissionlessly on blockchain and owner has not claimed the retirement on ICR
    - `reason` string — The reason for the retirement
    - `comment` string — A comment about the retirement
    - `beneficiary` string — The name of the retiree
    - `organizationId` string, required — The ID of the organization associated with the retirement
    - `organizationOwner` ApiEntityDto
      - `fullName` string, required — The full name of the entity
      - `logo` string, required — The url of the logo of the entity
      - `id` string, required — The ID of the entity
      - `publicUrl` string — The URL to the entity's public page on the CarbonRegistry.com
    - `serialization` string — The serialization of the carbon credits associated with the retirement
    - `vintage` string — The vintage year of the carbon credits associated with the retirement
    - `amount` number, required — The amount of the retirement
    - `project` ApiProject, required
      - `id` string, required — The ID of the project
      - `fullName` string, required — The full name of the project
      - `url` string, required — The URL of the project
      - `publicUrl` string, required — The public URL of the project
      - `num` number, required — Project number. This is a unique identifier for the project

---

[API](https://skmtc.net/carbonregistry/apis/carbonregistry-api.md) · [All operations](https://skmtc.net/carbonregistry/apis/carbonregistry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonregistry/carbonregistry-api/revisions/b0f71533dff5/schema)