---
title: "Transfer credits"
method: POST
path: "/v1/transfer"
tags: ["Credits"]
---

# Transfer credits

`POST /v1/transfer`

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

## Request body

- TransferCreditsRequestV1Dto
  - `to` TransferTo, required
    - `publicKey` string — The receiver's address
    - `email` string — The receiver's email - if this is supplied the owner of this email will be able to claim the transfer on an account they see fit.
    - `id` string — The receiver's entity Id
  - `fromId` string, required — The entity that holds the credits - if not a subaccountId the default subaccount will be used.
  - `credits` TransferCreditV1[], required — The credits to transfer
    - `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
  - `comment` string — An optional transaction comment
  - `receiptEmails` EmailDto[] — An optional list of emails to send the transaction receipt to
    - `email` string, required

## Response `200`

- TransferCreditsResponseDto
  - `transactionId` string, required — The transaction id
  - `success` boolean, required — Whether the transaction was successful or not

---

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