Skip to main content
GET
Track the status of an intent
Returns the state of intents, quotes, and gasless funding jobs. At least one filter is required; paging controls alone are rejected with 400. Exact lookups (intentHash, sourceTxHash, destinationTxHash, quoteId, jobId) always return 200; an unknown ID is reported with status: "unknown". wallet returns a page of intents and is the only filter status can be combined with. A consumed quote reports submitted with its intentHashes, per-step steps[], and sourceTx / destinationTx once known. quoteId and jobId are bare UUIDs, without the quote: or gasless: prefix. Requires x-api-key. Partner pricing, attribution, and enabled features are tied to the key. Without a key the gateway answers 403 with a plain JSON body ({"Message": "User is not authorized ..."}); a key that is unknown, revoked, or not enabled for v1 answers 401 invalid-api-key. No requests-per-second quota is published. Handle 429 and honor Retry-After when present. Examples use real mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs.

Authorizations

x-api-key
string
header
required

Query Parameters

intentHash
string

Exact lookup of one intent by its hash, as returned by POST /v1/quotes.

sourceTxHash
string

Exact lookup by the source-chain funding transaction hash.

destinationTxHash
string

Exact lookup by the destination-chain fulfillment transaction hash.

quoteId
string<uuid>

Exact lookup of a quote by its bare UUID, without the quote: prefix.

jobId
string<uuid>

Exact lookup of a gasless funding job by its bare UUID, without the gasless: prefix.

wallet
string

Pages through intents funded by, or delivered to, this wallet. The only filter that returns a collection.

Minimum string length: 1
status
enum<string>

Narrows a wallet page to one status. Rejected with 400 unless wallet is also supplied.

Available options:
pending,
filled,
settled,
refunded,
refundable,
expired,
failed,
unknown
cursor
string

Opaque cursor from a previous nextCursor.

Minimum string length: 1
limit
integer
default:20

Page size for wallet lookups, 1-50. Default 20.

Required range: 1 <= x <= 50

Response

Success

results
object[]
required
nextCursor
string | null
required