Five methods read order state. All are unary; poll rather than subscribe.

GetOrder

Everything known about one quote hash.
string
required
Hash returned by GetQuote.
QuoteView
The stored quote: hash, order parameters, fee breakdown, creation time. Always present.
Order
Present once the deposit is indexed. Carries state, confirmations, and transaction hashes.
Deposit
The matched source-chain deposit.
Fulfillment
Present once a fulfillment is attempted. Includes attempts, last error, and realized gas cost.
Refund
Present once a refund is attempted.
A quote that exists but has no deposit yet returns quote alone. Returns NOT_FOUND with quote not found if the hash is unknown.
Resolves an order from whichever hash the user has: the quote hash, the source transaction hash, or the destination transaction hash.
string
required
A quote hash or transaction hash. Empty input returns INVALID_ARGUMENT.
Returns the same OrderDetail as GetOrder, or NOT_FOUND with no order matched. This is the right call to put behind a support search box.

SearchAddress

Orders touching an address, as lightweight matches rather than full detail.
string
required
Address to look up.
AddressMatch[]
Each carries quote_hash, state, src_chain, dst_chain, and created_at.
Use it for an autocomplete or a compact history strip; fetch full detail per hash when the user picks one.

ListOrders

Paged order summaries for one address.
string
required
Address the orders belong to.
int64
Page size. Defaults to , clamped to .
string
Opaque cursor from the previous page’s next_cursor.
OrderSummary[]
Each carries the quote hash, the order, the deposit, both token addresses and amounts, the recipient, a gasless flag, and settled_at once the fulfillment or refund confirmed.
string
Absent on the last page.

ListRecentOrders

The same page shape, protocol-wide and newest first. Takes limit and cursor only. This is what the public explorer feed reads.

Notes

Order state is the only authority on settlement. dst_tx_hash is populated at submission, before confirmation. See Order lifecycle for the state list and types for full field definitions.