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) return 200 for a valid lookup, including an unknown ID 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 can answer 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. See Errors and retries for common errors and retry handling. Examples use mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs. They are illustrative and must not be used to transfer funds.

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