Skip to content
LogoLogo

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
400bad-requestA query parameter fails schema validation.
401missing-api-keyNo api-key header.
403invalid-api-keyInvalid API key.
429rate-limitedRate limit exceeded.
500transfer-service-failureUnexpected transfer service error.