Get Transfer

Retrieve a specific transfer intent by its unique ID. The inferred type is included in the summary.

GET /transfers/:id

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The transfer intent ID (e.g. `int_transfer_01HT...`).

Response

Returns a TransferSummary object. The full transaction payload is available on the create response; summaries include only metadata.

{
  "id": "int_transfer_01HT...",
  "type": "transfer",
  "status": "pending",
  "orderId": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "createdAt": "2026-06-05T12:00:00Z",
  "updatedAt": "2026-06-05T12:00:00Z",
  "metadata": {
    "chainId": "eip155:11155111",
    "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
404	NotFoundError	No transfer exists for the given ID.
422	BlockchainError	On-chain query failure.
422	ChainNotConfiguredError	The transfer's chain is no longer supported.
422	IntentIdError	Invalid intent ID format.
500	TransferServiceError	Unexpected transfer service error.