Skip to content
Logo

List Transfers

List all transfer intents for the authenticated account. Use the type query parameter to filter by inferred operation type.

GET /transfers
GET /transfers?type=bridge

Query Parameters

ParameterTypeRequiredDescription
typeenumNoFilter by inferred operation type: transfer, swap, or bridge.

Response

Returns an array of TransferSummary objects. Summaries omit the full tx payload to keep responses lightweight.

[
  {
    "id": "int_transfer_01HT...",
    "type": "bridge",
    "status": "confirmed",
    "orderId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "createdAt": "2026-06-05T12:00:00Z",
    "updatedAt": "2026-06-05T12:05:00Z",
    "metadata": {
      "chainId": "eip155:1",
      "hash": "0x..."
    }
  }
]

Response Fields

FieldTypeDescription
idstringUnique intent ID.
typestringInferred operation type: transfer, swap, or bridge.
statusstringCurrent lifecycle status. See Intent Lifecycle.
orderIdstringDeterministic on-chain order identifier (bytes32 hex).
createdAtstringISO 8601 creation timestamp.
updatedAtstringISO 8601 last update timestamp.
metadataobjectChain ID and optional transaction hash.

Errors

HTTPTypeWhen
500TransferServiceErrorUnexpected transfer service error.