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

# List Transfers

`GET /v1/transfers`

Retrieves a paginated list of PIX transfers for the authenticated account. Supports filtering by external_reference_id and cursor-based pagination for efficient data retrieval.

## Query parameters

- `external_reference_id` string, nullable
- `transaction_id` integer, nullable
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

Transfers retrieved successfully

- GetTransfersResponse
  - `next_cursor` string, nullable — Cursor for next page (null if no more results)
  - `transfers` TransferItemResponse[], required — List of transfer items
    - `amount_in_cents` integer, required — Transfer amount in centavos.
    - `beneficiary` union, required
      - object
        - `pix_key` string, required
        - `resolved_account_number` string, nullable
        - `resolved_account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
        - `resolved_branch` string, nullable
        - `resolved_ispb` string, nullable
        - `name` string, nullable
        - `tax_id` string, nullable
      - object
        - `account_number` string, required
        - `account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
        - `branch_code` string, required
        - `ispb` string, required
        - `resolved_account_number` string, nullable
        - `resolved_account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
        - `resolved_branch` string, nullable
        - `resolved_ispb` string, nullable
        - `name` string, nullable
        - `tax_id` string, nullable
    - `created_at` string, date-time, required — Transfer creation timestamp (UTC, RFC 3339).
    - `display_description` string, nullable — Description shown to the beneficiary.
    - `end_to_end_id` string, nullable — PIX End-to-End ID assigned after successful processing.
    - `external_reference_id` string, nullable — Client-provided reference identifier.
    - `failed_message` string, nullable — Failure reason when status is `failed`.
    - `id` integer, required — Transfer identifier.
    - `scheduled_date` string, date, nullable — Scheduled execution date (`YYYY-MM-DD`). Null when executed immediately.
    - `status` 'awaiting_approval' | 'pending' | 'processing' | 'success' | 'cancelled' | 'failed', required
    - `transaction_id` integer, nullable — Ledger transaction identifier, available after processing.

## Other responses

- `400` — Invalid query parameters. Error code: INVALID_REQUEST (invalid cursor format or limit out of range 1–100)
- `401` — Authentication failed
- `403` — Access denied - requires ViewTransactions permission
- `500` — Internal server error

---

[API](https://skmtc.net/kiwify/apis/conta-digital-api.md) · [All operations](https://skmtc.net/kiwify/apis/conta-digital-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kiwify/conta-digital-api/revisions/eea178ae3207/schema)