---
title: "List Transfers"
method: GET
path: "/v1/transfer"
tags: ["Transfers"]
---

# List Transfers

`GET /v1/transfer`

Request a list of transfers, filtered by the specified criteria.

## Query parameters

- `page_size` integer, required
- `page_number` integer, required
- `start_time` string
- `end_time` string
- `transfer_status` 'completed' | 'failed'
- `currency` string

## Response `200`

OK - Successfully retrieved a list of transfers.

- TransferListResponse
  - `total_pages` integer — The total pages of available items.
  - `total_items` integer — The total counts of available items.
  - `data` TransferEntity[] — List of transfer records.
    - `transfer_id` string, required — A unique UUID identifier for the transfer transaction.
    - `reference_id` string, required — The reference generated by the system to identify the entity.
    - `short_reference_id` string, required — The shorter reference generated by the system to identify the entity.
    - `source_account_name` string, required — The name of the account from which the funds are transferred.
    - `destination_account_name` string, required — The name of the account receiving the transferred funds.
    - `transfer_currency` string, required — The currency used for the transfer. Currency codes follow the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) standard.
    - `transfer_amount` string, required — The amount of money transferred.
    - `transfer_status` 'completed' | 'failed', required — Indicates the current status of the transfer transaction. Valid values are: - `completed`: indicates that the transfer transaction has been successfully completed. - `failed`: indicates that the transfer transaction has failed.
    - `create_time` string, required — The timestamp when the request was initiated in the system.
    - `complete_time` string, required — The timestamp when the request was successfully processed and marked as `COMPLETED`.
    - `created_by` string, required — The identifier of the user or system that initiated the transfer.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)