---
title: "POST /carbonCredits/retire/credits"
method: POST
path: "/carbonCredits/retire/credits"
tags: ["CarbonCredits"]
---

# POST /carbonCredits/retire/credits

`POST /carbonCredits/retire/credits`

## Request

- Base URL: `https://api.carbonregistry.com`
- URL: `https://api.carbonregistry.com/carbonCredits/retire/credits`
- Auth: none declared
- TypeScript: <https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/docs/carbonCredits/retire/credits/post.ts> (a function with typed inputs; its response is checked against the schema)

Transfers company credits to another...

## Request body

- RetireCreditsRequestDto
  - `to` TransferTo
    - `publicKey` string: The receiver's address
    - `email` string: The receiver's email
    - `id` string: The receiver's account ID
  - `fromPublicKey` string, required: The wallet where the credits will come from
  - `retirementCertificateData` RetirementCertificateData
    - `reason` string, required: The reason for retirement
    - `beneficiaryName` string, required: The beneficiary for the retirement
    - `comment` string: An optional transaction comment
  - `credit` TransferCredit, required
    - `tokenId` string, required
    - `amount` number, required: The amount of credits to transfer
  - `projectAddress` string, required: The project address
  - `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.dev/carbonregistry/apis/carbon-registry-rest-api.md) - [All operations](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/revisions/a9f1b102faca?raw)