Skip to navigation

List Routes

Return every route on the authenticated organization. Each route includes the full instructions block so callers can resolve memos and mint/redeem addresses without an additional retrieve.

Narrow the list with fromCurrency, toCurrency, toChain, direction, and toAccountId; every filter you send must hold (see Filtering list endpoints). toChain matches onchain destinations only, so a redeem-to-fiat route never matches it. direction filters by flow without naming a currency pair — see the Supported topologies table on POST /v0/routes for what each value means.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Query parameters

cursorstringOptional

Opaque pagination cursor. Pass the nextCursor from the previous response; omit to fetch the first page.

limitintegerOptional1-200Defaults to 50

Page size. Defaults to 50; capped at 200.

fromCurrencyenumOptional
Return only routes with this source currency.
Allowed values:
directionlist of enumsOptional

Return only routes in any of these directions, comma-separated. Omit for every direction the caller can read. This is how “every redeem regardless of token” is spelled: direction=redeem-fiat,redeem-stablecoin.

Allowed values:
toAccountIdstringOptionalformat: "uuid"

Return only routes pointing at this registered account. A well-formed id belonging to another organization, or to nothing, returns an empty page rather than an error.

toChainlist of enumsOptional

Return only routes landing on any of these chains, comma-separated. Fiat and wire destinations carry no chain and are never matched by this filter.

toCurrencyenumOptional
Return only routes with this destination currency.
Allowed values:

Response

OK
datalist of objects

Page of routes, newest first, tie-broken by id.

nextCursorstring or null

Opaque cursor for the next page. Pass back verbatim as the cursor query param to fetch the next page; null when no more results.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error