Skip to main content
GET
cURL

Headers

x-api-key
string
required

API key for authentication.

Query Parameters

limit
number
default:20

Maximum number of requests to return per page.

Required range: 1 <= x <= 100
continuation
string

Pagination cursor returned by a previous response. Pass it back to fetch the next page.

includeTotal
boolean
default:false

When true, also compute and return the total count of requests matching these filters (ignores limit/continuation). Adds latency — omit unless the total is needed.

user
string

Filter requests by wallet address — matches requests where this address is the sender or the deposit-address depositor.

term
string

Broad term search across request ID, wallet, deposit address, and all transaction hashes (deposit, fill, refund, failed, and chain entry transaction IDs). Use id, depositTxHash, fillTxHash, or refundTxHash for targeted single-field lookups.

id
string

Filter by requestId — the Relay-level intent identifier returned by the quote API.

orderId
string

Filter by protocol-level orderId.

depositTxHash
string

Filter by deposit transaction hash.

fillTxHash
string

Filter by fill transaction hash.

refundTxHash
string

Filter by refund transaction hash.

originChainId
number

Filter requests where this is the origin chain.

destinationChainId
number

Filter requests where this is the destination chain. Requests are limited to the caller’s integrator and requests without an API key.

chainId
number

Get all requests for a single chain in either direction. Overridden by originChainId / destinationChainId. Requests are limited to the caller’s integrator and requests without an API key.

privateChainsToInclude
string

Comma-separated list of private chain UUIDs to include in results.

depositAddress
string

Filter requests associated with this deposit address.

recipient
string

Filter requests where this address is the recipient.

status
enum<string>

Filter requests by status.

Available options:
success,
failure,
refund,
pending,
depositing
failReason
enum<string>

Filter requests by failure reason. Only returns requests that failed with this specific reason.

Available options:
UNKNOWN,
SLIPPAGE,
AMOUNT_TOO_LOW_TO_REFUND,
DEPOSIT_ADDRESS_MISMATCH,
DEPOSIT_CHAIN_MISMATCH,
INCORRECT_DEPOSIT_CURRENCY,
DOUBLE_SPEND,
SOLVER_CAPACITY_EXCEEDED,
SOLVER_BALANCE_TOO_LOW,
DEPOSITED_AMOUNT_TOO_LOW_TO_FILL,
NEGATIVE_NEW_AMOUNT_AFTER_FEES,
NO_QUOTES,
MISSING_REVERT_DATA,
REVERSE_SWAP_FAILED,
GENERATE_SWAP_FAILED,
TOO_LITTLE_RECEIVED,
EXECUTION_REVERTED,
NEW_CALLDATA_INCLUDES_HIGHER_RENT_FEE,
TRANSACTION_REVERTED,
TRANSACTION_TOO_LARGE,
ORIGIN_CURRENCY_MISMATCH,
NO_INTERNAL_SWAP_ROUTES_FOUND,
SWAP_USES_TOO_MUCH_GAS,
INSUFFICIENT_FUNDS_FOR_RENT,
SPONSOR_BALANCE_TOO_LOW,
ORDER_EXPIRED,
ORDER_IS_CANCELLED,
TRANSFER_FROM_FAILED,
TRANSFER_FAILED,
SIGNATURE_EXPIRED,
INVALID_SIGNATURE,
INSUFFICIENT_NATIVE_TOKENS_SUPPLIED,
TRANSFER_AMOUNT_EXCEEDS_ALLOWANCE,
TRANSFER_AMOUNT_EXCEEDS_BALANCE,
INVALID_SENDER,
ACCOUNT_ABSTRACTION_INVALID_NONCE,
ACCOUNT_ABSTRACTION_SIGNATURE_ERROR,
SEAPORT_INEXACT_FRACTION,
TOKEN_NOT_TRANSFERABLE,
ZERO_SELL_AMOUNT,
MINT_NOT_ACTIVE,
ERC_1155_TOO_MANY_REQUESTED,
INCORRECT_PAYMENT,
INVALID_GAS_PRICE,
FLUID_DEX_ERROR,
ORDER_ALREADY_FILLED,
SEAPORT_INVALID_FULFILLER,
INVALID_SIGNER,
MINT_QUANTITY_EXCEEDS_MAX_PER_WALLET,
MINT_QUANTITY_EXCEEDS_MAX_SUPPLY,
JUPITER_INVALID_TOKEN_ACCOUNT,
INVALID_NONCE,
ACCOUNT_ABSTRACTION_GAS_LIMIT,
CONTRACT_PAUSED,
SWAP_IMPACT_TOO_HIGH,
INSUFFICIENT_POOL_LIQUIDITY,
POOL_CAP_EXCEEDED,
TTL_EXPIRED,
DEPOSIT_CONFIRMATION_TIMEOUT,
ORPHANED_DEPOSIT_REFUND,
GASLESS_PERMIT_BALANCE_TOO_LOW,
MANUAL_ADMIN_REFUND,
QUOTED_GAS_LIMIT_EXCEEDED,
DESTINATION_TOKEN_TRANSFER_REJECTED,
DEPOSIT_REORGED,
BLOCKED_WALLET,
PROTOCOL_DEADLINE_EXPIRED,
TRANSACTION_NOT_INCLUDED,
TRANSACTION_SUBMISSION_FAILED,
N/A
refundFailReason
enum<string>

Filter requests by refund failure reason.

Available options:
AMOUNT_TOO_LOW_TO_REFUND,
NEGATIVE_NEW_AMOUNT_AFTER_FEES,
SWAP_CURRENCY_NOT_ON_ORIGIN,
REFUND_RECIPIENT_IS_VASP,
REFUND_RECIPIENT_IS_BLOCKED,
MANUAL_REFUND_REQUIRED
apiKey
string

Filter requests by API key. Accepts a single value or a comma-separated list (OR matching). Maximum 50 values across apiKey and apiKeyId.

appId
string

Filter by App IDs (app_id_, comma-separated, maximum 50) owned by your integrator. Matches indexed App attribution across current and revoked keys.

apiKeyId
string

Filter by API key IDs (lowercase key_id_, comma-separated), owned by your integrator. OR matching with apiKey; maximum 50 values combined.

requestType
string

Filter requests by requestType (case-insensitive). Supported values: Bridge, Crosschain Swap, Same-chain Swap, Send, Wrap, Unwrap, Call.

referrer
string

Filter requests by the exact referrer value supplied at quote time. Without apiKeyId or apiKey, returns only matching public keyless requests. Every supplied key must belong to the authenticating integrator. Includes matching requests for the selected keys and public requests with neither a recorded API key nor a legacy fill API key, regardless of age. Existing visibility restrictions still apply; public requests are not assigned to your integrator.

Minimum string length: 1
currencyInChainId
number

Filter by origin currency chain ID.

currencyOutChainId
number

Filter by destination currency chain ID. Requests are limited to the caller’s integrator and requests without an API key.

currencyInAddress
string

Filter by origin currency contract address.

currencyOutAddress
string

Filter by destination currency contract address. Requests are limited to the caller’s integrator and requests without an API key.

currencyInSymbol
string

Filter by origin currency symbol (e.g. USDC). Case-insensitive; matches across all chains.

currencyOutSymbol
string

Filter by destination currency symbol (e.g. USDC). Case-insensitive; matches across all chains. Requests are limited to the caller’s integrator and requests without an API key.

sortBy
enum<string>
default:createdAt

Field to sort by.

Available options:
createdAt,
updatedAt,
amountUsd
sortDirection
enum<string>

Sort direction (default: desc for time fields, asc for amountUsd).

Available options:
asc,
desc
startTimestamp
number

Filter requests with createdAt ≥ this Unix timestamp (seconds). Applied to updatedAt instead when sortBy=updatedAt.

endTimestamp
number

Filter requests with createdAt ≤ this Unix timestamp (seconds). Applied to updatedAt instead when sortBy=updatedAt.

startBlock
number

Filter by chain entry block number (inclusive lower bound). When originChainId is also set, scoped to origin-chain entries only.

endBlock
number

Filter by chain entry block number (inclusive upper bound). When originChainId is also set, scoped to origin-chain entries only.

amountUsdMin
number

Filter requests with currencyIn.amountUsd ≥ this value.

amountUsdMax
number

Filter requests with currencyIn.amountUsd ≤ this value.

appFeesAmountUsdMin
number

Filter requests with total app fees USD ≥ this value.

appFeesAmountUsdMax
number

Filter requests with total app fees USD ≤ this value.

fillTimeMin
number

Filter requests with fill time ≥ this value (seconds).

fillTimeMax
number

Filter requests with fill time ≤ this value (seconds).

features
string

Comma-separated feature flags to filter by. Requests must have at least one of the specified features. Supported values: gasless_execution, gasless_swap, fast_fill, gas_top_up, fixed_rate, app_fees, deposit_address, fee_sponsorship.

includePendingRequests
boolean

When true, include pending requests permitted by your access scope and pending transactions for your own requests. Defaults to false. Does not enable authenticated fields or change access permissions; terminal requests remain eligible without this flag.

includeAuthenticatedData
boolean

When true, include fields available only to the authenticating integrator for their own requests.

includeChildRequests
boolean

Only effective when id is also provided. When true, returns the parent request AND any child requests. When false or omitted, only the exact request_id match is returned.

filters
string

JSON-encoded array of filter-group objects. Fields within each group are AND'd; groups are OR'd. Prefix a key with 'not:' to negate it (must_not). Values can be a scalar or an array (OR semantics within the field). Example: [{"depositAddress":"0xabc","originChainId":8453},{"depositAddress":"0x123","originChainId":1}]. Negation example: [{"not:status":"failure"}]. Array value example: [{"not:status":["failure","refund"]}]. A value of null is a null-check ("is empty"/"is not empty") instead of an equality test, for any key. Null-check example: [{"depositAddress":null}] (is empty / does not exist), [{"not:depositAddress":null}] (is not empty / exists). null cannot be combined with real values in an array. At most 50 distinct string values across id, term, and grouped id/term filters (including negations) are allowed; a top-level id with includeChildRequests is excluded from this limit. Requests are limited to the caller’s integrator and requests without an API key. A referrer key (or not:referrer) without top-level apiKeyId or apiKey limits that group to public keyless requests. Optional key parameters must contain keys owned by the authenticating integrator. Referrer groups also include matching public keyless requests regardless of age; groups without a referrer retain their existing scope unless a top-level referrer is supplied.

Response

200 - application/json

Default Response

requests
object[]
continuation
string
total
number

Total count of requests matching the given filters. Only present when includeTotal was true.