> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Transfers

> List transfers for an account, newest first, with filters

Returns a paginated list of transfers for the account, newest first.

<Note>
  `virtual_account_id` has the highest priority among the virtual-account filters — when set, `from_virtual_account_id` and `to_virtual_account_id` are ignored.
</Note>

## Path Parameters

<ParamField path="account_id" type="string" required>
  Account id.
</ParamField>

## Query Parameters

<ParamField query="page" type="int">
  Page number. Default 1, minimum 1.
</ParamField>

<ParamField query="size" type="int">
  Page size. Default 20, range 1–100.
</ParamField>

<ParamField query="status" type="TransferStatus | null">
  Filter by status: `pending` | `completed` | `failed`.
</ParamField>

<ParamField query="currency" type="Currency | null">
  Filter by transfer currency.
</ParamField>

<ParamField query="id" type="string | null">
  Filter by transfer id (`atx_…`).
</ParamField>

<ParamField query="virtual_account_id" type="string | null">
  Matches transfers where this virtual account is either the source or the destination. Highest priority — when set, `from_virtual_account_id` and `to_virtual_account_id` are ignored.
</ParamField>

<ParamField query="from_virtual_account_id" type="string | null">
  Exact match on the source side only. Ignored when `virtual_account_id` is set.
</ParamField>

<ParamField query="to_virtual_account_id" type="string | null">
  Exact match on the destination side only. Ignored when `virtual_account_id` is set.
</ParamField>

## Response

Returns `200` with a paginated list of transfer objects (see Get Transfer for the object attributes).

<ResponseField name="items" type="array">
  Transfer objects in the current page.
</ResponseField>

<ResponseField name="page" type="integer">
  Current page number.
</ResponseField>

<ResponseField name="size" type="integer">
  Items per page.
</ResponseField>

<ResponseField name="total" type="integer">
  Total items across all pages.
</ResponseField>

<ResponseField name="pages" type="integer">
  Total number of pages.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "items": [
      {
        "object": "transfer",
        "id": "atx_abc123def456ghi789jkl012",
        "source_virtual_account_id": "va_src1a2b3c4d5e6f7g8h9i0j2",
        "destination_virtual_account_id": "va_dst3c4d5e6f7g8h9i0j1k2l3",
        "amount": "500.00",
        "currency": "USD",
        "reference": "Sweep to operating account",
        "internal_note": "month-end rebalance",
        "status": "completed",
        "completed_at": "2026-05-30T09:00:00Z",
        "failed_at": null,
        "failed_reason": null,
        "created": "2026-05-30T09:00:00Z",
        "updated": null,
        "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
        "updated_by": null
      }
    ],
    "page": 1,
    "size": 20,
    "total": 1,
    "pages": 1
  }
  ```
</ResponseExample>