---
title: "Retrieve a transfer"
method: GET
path: "/transfers/{id}"
tags: ["Transfers"]
---

# Retrieve a transfer

`GET /transfers/{id}`

## Request

- Base URL: `https://transfers.checkout.com`
- URL: `https://transfers.checkout.com/transfers/{id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `transfers:view`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/transfers/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve transfer details using the transfer identifier.

## Path parameters

- `id` string, required

## Response `200`

Transfer found

- Transfer
  - `id` string: The transfer identifier
  - `reference` string: A unique reference used to identify this transfer
  - `status` 'pending' | 'completed' | 'rejected': The current state of the initiated transfer.
  - `transfer_type` 'commission' | 'promotion' | 'refund': The type of transfer
  - `requested_on` string: The date the transfer was requested on
  - `reason_codes` string[]: An optional set of reason codes describing why the transfer is in its current state
  - `source` object: The source of the funds involved in the transfer
    - `entity_id` string: The ID of the entity that sent the transfer
    - `amount` integer: The amount transferred, in the minor unit of the currency represented by the `currency` property
    - `currency` string: The ISO currency code of the funds being transferred
  - `destination` object: The destination of the funds involved in the transfer
    - `entity_id` string: The ID of the entity that received the transfer
  - `_links` object
    - `self` TransferLink
      - `href` string: The link URL.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Transfer not found
- `422`: Invalid data was sent

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)