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

# Retrieve a transfer by Id

`GET /transfers/{id}`

This is used to fetch a transfer by its unique Id

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved the given Transfer

- Transfer
  - `id` string — The unique id of the transfer
  - `status` 'Pending' | 'Declined' | 'Completed' — The status the transfer is currently in
  - `amount` integer — The transfer amount (in minor units)
  - `currency` string — The ISO currency code
  - `reason` string, nullable — An optional reason describing why the transfer was initiated.
  - `source` object, nullable — Where the `amount` was taken from
    - `accountId` string — ID of the Ryft account that funds were taken from
  - `destination` object, nullable — Where the `amount` will be credited to
    - `accountId` string — ID of the Ryft account that will receive the funds
  - `errors` object[], nullable — Details any errors explaining why the transfer was `Declined`.
    - `code` string — code for the error
    - `description` string — Text describing the error
  - `metadata` object, nullable — Your custom key-value data for the transfer. You can have a maximum of 5 pieces of metadata.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the transfer was created
  - `lastUpdatedTimestamp` integer — The epoch timestamp (seconds) when the transfer was last updated

## Other responses

- `404` — The requested account/transfer could not be found
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)