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

# List Transfers

`GET /transfers`

Lists an account's transfers.

## Query parameters

- `origin_id` string
- `destination_id` string
- `order` 'created_at' | 'amount'
- `direction` 'asc' | 'desc'
- `created_before` string
- `created_after` string
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

transfers listed

- object
  - `data` object[], required
    - `amount` number, required — Transfer amount.
    - `created_at` string, date-time, required — When the transfer was created.
    - `created_by_user` object, nullable, required — The user who initiated the transfer, such as the team member who sent a manual payout. Null if the creator is unavailable.
      - `id` string, required — User ID.
      - `name` string, nullable — User display name.
      - `username` string, required — User's username.
    - `currency` string, required — Transfer currency.
    - `destination_ledger_account_id` string, required — Destination ledger account ID.
    - `fee_amount` number, nullable — Fee charged for the transfer.
    - `id` string, required — Transfer ID.
    - `metadata` object, nullable — Custom metadata attached to the transfer.
    - `notes` string, nullable — Transfer note.
    - `object` 'transfer', required — The object type.
    - `origin_ledger_account_id` string, required — Source ledger account ID.
    - `status` 'processing' | 'succeeded' | 'failed', required — Transfer status. `processing` means the on-chain leg is still executing — poll the transfer until it resolves to `succeeded` or `failed`.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)
