---
title: "Retire credits"
method: POST
path: "/v1/retire"
tags: ["Credits"]
---

# Retire credits

`POST /v1/retire`

For retiring credits this is THE endpoint to use. You can retire credits from an organization, user or subaccount.

## Request body

- RetireCreditsRequestV1Dto
  - `to` RetireTo
    - `email` string — The receiver's email
    - `id` string — The receiver's entity Id
  - `fromId` string, required — The entity that holds the credits
  - `reason` string, required — The reason for retirement. This reason comes from a specified picklist.
  - `beneficiaryName` string, required — The beneficiary for the retirement
  - `comment` string, required — A retirement comment
  - `credit` TransferCreditV1, required
    - `id` string, required — The id of the credit - you can get this id by querying the inventory of the entity that is doing the transfer / retire.
    - `amount` number, required — The amount of credits to transfer - can be fractional - denomination is tonnes CO2-e
  - `receiptEmails` EmailDto[] — An optional list of emails to send the transaction receipt to
    - `email` string, required

## Response `200`

- RetireCreditsResponseDto
  - `success` boolean, required — Whether the transaction was successful or not
  - `transactionId` string, required — The id of the possibly pending transaction

---

[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)