# Fetches a paginated list of your transfers

Retrieves a list of the transfers you've requested. Returned in sorted (by epoch) order (default is newest first)

Endpoint: GET /transfers
Version: 1.1.0
Security: secretApiKeyAuth

## Query parameters:

  - `ascending` (boolean)
    Control the order (newest or oldest) in which the transfers are returned. false will arrange the results with newest first whereas true shows oldest first

  - `limit` (integer)
    Control how many transfers are returned in the result list. The max limit we allow is 50.
    Example: 20

  - `startsAfter` (string)
    A token to identify where to resume a subsequent paginated query. The value of the paginationToken field from that response should be supplied here in order to retrieve the next page of results.
    Example: "tfr_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 200 fields (application/json):

  - `items` (array)

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

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

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

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

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

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

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

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

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

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

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

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

  - `items.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"}

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

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

  - `paginationToken` (string,null)
    A token to use for getting the next page of results - send the same request with this value in the 'startsAfter' query parameter. This field is null when there are no further items to return.
    Example: "tfr_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 400 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"