# Retrieve a transfer by Id

This is used to fetch a transfer by its unique Id

Endpoint: GET /transfers/{id}
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `id` (string, required)
    Transfer to retrieve
    Example: "tfr_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 200 fields (application/json):

  - `id` (string)
    The unique id of the transfer
    Example: "tfr_01FCTS1XMKH9FF43CAFA4CXT3P"

  - `status` (string)
    The status the transfer is currently in
    Enum: "Pending", "Declined", "Completed"

  - `amount` (integer)
    The transfer amount (in minor units)
    Example: 75000

  - `currency` (string)
    The ISO currency code
    Example: "GBP"

  - `reason` (string,null)
    An optional reason describing why the transfer was initiated.
    Example: "Covering dispute fees of £25 from 25th October"

  - `source` (object,null)
    Where the amount was taken from

  - `source.accountId` (string)
    ID of the Ryft account that funds were taken from
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

  - `destination` (object,null)
    Where the amount will be credited to

  - `destination.accountId` (string)
    ID of the Ryft account that will receive the funds
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

  - `errors` (array,null)
    Details any errors explaining why the transfer was Declined.

  - `errors.code` (string)
    code for the error
    Example: "InsufficientSourceBalance"

  - `errors.description` (string)
    Text describing the error
    Example: "The account did not have sufficient funds available to cover this transfer"

  - `metadata` (object,null)
    Your custom key-value data for the transfer. You can have a maximum of 5 pieces of metadata.
    Example: {"orderId":"1","customerId":"123"}

  - `createdTimestamp` (integer)
    The epoch timestamp (seconds) when the transfer was created
    Example: 1470989538

  - `lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the transfer was last updated
    Example: 1470989538

## Response 404 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"