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
| Parameter | Type | Required | Description |
|---|
type | enum | No | Filter 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
| Field | Type | Description |
|---|
id | string | Unique intent ID. |
type | string | Inferred operation type: transfer, swap, or bridge. |
status | string | Current lifecycle status. See Intent Lifecycle. |
orderId | string | Deterministic on-chain order identifier (bytes32 hex). |
createdAt | string | ISO 8601 creation timestamp. |
updatedAt | string | ISO 8601 last update timestamp. |
metadata | object | Chain ID and optional transaction hash. |
Errors
| HTTP | Type | When |
|---|
| 500 | TransferServiceError | Unexpected transfer service error. |