---
title: "Fetches a paginated list of your transfers"
method: GET
path: "/transfers"
tags: ["Transfers"]
---

# Fetches a paginated list of your transfers

`GET /transfers`

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

## Query parameters

- `ascending` boolean
- `limit` integer — Control how many transfers are returned in the result list. The max limit we allow is `50`.
- `startsAfter` string

## Response `200`

Successfully retrieved your transfers

- Transfers
  - `items` 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
  - `paginationToken` string, nullable — 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.

## Other responses

- `400` — One or more inputs are invalid
- `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)