List transfers for your organization. Use this to view and monitor your transfer activity.

Sorting: Results are sorted by creation time in descending order (newest first). Transfers with the same creation time are returned in a consistent order across pages.

Status Filtering: Filter by specific status to efficiently manage transfers:

• ?status=processing - Monitor active transfers.
• ?status=quoted - Find transfers awaiting execution.
• ?status=failed - Review failed transfers for troubleshooting.
• ?status=completed - Find completed transfers.

Account Filtering: Filter by account ID to find transfers involving a specific account:

• ?accountId=<ID> - All transfers where the account is either source or target (OR semantics).
• ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound).
• ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId, targetAccountId, sourceAddress, targetAddress, or targetEmail is a validation error and returns HTTP 400.

Date Range Filtering: Filter by creation or last-updated time for reconciliation:

• ?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range.
• ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync.

Asset Filtering: Filter by source or target asset symbol:

• ?sourceAsset=usd - Transfers funded from a USD account.
• ?targetAsset=usdc - Transfers delivering USDC to the target. Supported asset symbols include usdc, eurc, usd, and eur.

Other Filters:

• ?sourceAddress=0x... - Transfers from a specific on-chain source address.
• ?targetAddress=0x... - Transfers to a specific on-chain destination address.
• ?targetEmail=user@example.com - Transfers to a specific email recipient.
• ?transferId=transfer_... - Look up a single transfer by ID; bypasses pagination.

Filter Combinations: The following combinations are validation errors and return HTTP 400:

• accountId with any of sourceAccountId, targetAccountId, sourceAddress, targetAddress, or targetEmail.
• sourceAccountId with sourceAddress.
• More than one of targetAccountId, targetAddress, and targetEmail.
• transferId with any other filter. Pagination parameters are permitted.

{
  "transfers": [
    {
      "transferId": "transfer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "status": "completed",
      "source": {
        "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
        "asset": "usd"
      },
      "target": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "network": "base",
        "asset": "usdc"
      },
      "sourceAmount": "103.50",
      "sourceAsset": "usd",
      "targetAmount": "100.00",
      "targetAsset": "usdc",
      "completedAt": "2025-01-01T00:05:00Z",
      "createdAt": "2025-01-01T00:00:00Z",
      "updatedAt": "2025-01-01T00:05:00Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}