Skip to content
LogoLogo

Get Transfer

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

GET /transfers/:id

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe 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. The quote projection (provider, route, in, out) is returned on create only and is not persisted, so a summary never carries it.

{
  "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...",
    "transfers": [
      {
        "type": "transfer",
        "recipient": "eip155:11155111:0x8f66...",
        "token": "eip155:11155111:0xA0b8...",
        "amount": "1000000",
        "outputHash": "0x..."
      }
    ]
  }
}

Response Fields

FieldTypeDescription
idstringUnique intent ID.
typestringInferred operation type: transfer, swap, bridge, or batch. A request with more than one transfer answers batch.
statusstringCurrent lifecycle status. See Intent Lifecycle.
orderIdstringDeterministic on-chain order identifier (bytes32 hex).
createdAtstringISO 8601 creation timestamp.
updatedAtstringISO 8601 last update timestamp.
metadataobjectChain ID, optional transaction hash, and transfers.
metadata.transfersarrayOne record per transfer, in request order: { type, recipient, token, amount, outputHash }. type is that transfer's own classification, never batch; amount is the delivered amount; no record carries an index or any quote member. outputHash is present whenever the intent committed one; an intent created before the canonical-output table existed may omit it.

Errors

HTTPTypeWhen
400bad-requestMalformed JSON or a query that fails schema validation.
401missing-api-keyNo api-key header.
403invalid-api-keyInvalid API key.
404transfer-not-foundNo transfer exists for the given ID.
429rate-limitedRate limit exceeded.
500transfer-service-failureUnexpected transfer service error.