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

# POST /carbonCredits/retire/credits

`POST /carbonCredits/retire/credits`

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.net/carbonregistry/apis/carbon-registry-rest-api.md) · [All operations](https://skmtc.net/carbonregistry/apis/carbon-registry-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonregistry/carbon-registry-rest-api/revisions/a9f1b102faca/schema)