---
title: "List transfers"
method: GET
path: "/api/transfers"
tags: ["Transfers"]
---

# List transfers

`GET /api/transfers`

Paginated list of transfers for the tenant, ordered by creation date descending.

## Query parameters

- `pageToken` string
- `pageSize` integer

## Headers

- `x-tenant-id` string, required

## Response `200`

Transfer list

- TransferListResponse
  - `transfers` TransferSummary[]
    - `id` string, uuid
    - `tenantId` string
    - `transferId` string, uuid
    - `state` 'INITIATED' | 'SUBMITTED' | 'ACCEPTED' | 'SETTLED' | 'RETURNED' | 'FAILED'
    - `rail` string, nullable
    - `intent` 'AUTH' | 'CAPTURE' | 'PUSH' | 'PULL'
    - `amount` string — Amount as string
    - `currency` string
    - `payerRef` string, nullable
    - `payeeRef` string, nullable
    - `externalRef` string, nullable
    - `endUserRef` string, nullable
    - `latestEventType` string, nullable
    - `latestEventAt` string, date-time, nullable
    - `version` integer
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `nextPageToken` string, nullable
  - `pageSize` integer

## Other responses

- `401` — Missing or invalid authentication
- `500` — Internal server error

---

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