---
title: "List Routes"
method: GET
path: "/v0/routes"
tags: ["Routes"]
---

# List Routes

`GET /v0/routes`

<Callout intent="warning">
  The endpoints exposed here are currently in **Beta**! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution.
</Callout>

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`, and `toAccountId`; every filter you send must hold (see [Filtering list endpoints](/api#filtering-list-endpoints)). `toChain` matches on-chain destinations only, so a redeem-to-fiat route never matches it.

## Query parameters

- `cursor` string
- `limit` integer
- `fromCurrency` 'ausd' | 'stablecoin' | 'usd' — Return only routes with this source currency. The `stablecoin` wildcard matches routes stored against the wildcard; it does not expand to the individual stablecoins it covers.
- `toAccountId` string, uuid
- `toChain` V0RoutesGetParametersToChainSchemaItems[]
- `toCurrency` 'ausd' | 'usd' | 'usdc' — Return only routes with this destination currency.

## Headers

- `Authorization` string, required

## Response `200`

OK

- RoutesGetResponse200
  - `data` V0RoutesGetResponsesContentApplicationJsonSchemaDataItems[], required — Page of routes, newest first, tie-broken by id.
    - `id` string, uuid, required — Deterministic route UUID; same canonical inputs always derive the same id.
    - `name` string, nullable — User-set label, or null when unset.
    - `createdAt` string, date-time, required
    - `from` V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsFrom, required
      - `currency` 'ausd' | 'stablecoin' | 'usd' | 'usdc', required — Currency identifier.
    - `to` V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsTo, required
      - `currency` 'ausd' | 'stablecoin' | 'usd' | 'usdc', required — Currency identifier.
      - `accountId` string, uuid, required
      - `chain` 'arbitrum' | 'avalanche' | 'base' | 'ethereum' | 'immutable' | 'monad' | 'polygon-pos' | 'solana' — Route chain (kebab-case). Restricted to chains Agora supports for routes (EVM + Solana).
    - `instructions` V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsInstructionsItems[], required — Next-step instructions. Mint-fiat: one wire instruction with memo + beneficiary. On-chain directions: one deposit address per supported chain, alphabetical by chain.
      - union
        - V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsInstructionsItems0
          - `memo` string, required — Memo / reference field that uniquely identifies the route on the inbound wire.
          - `beneficiaryName` string, required
          - `beneficiaryAddress` string, required
          - `accountNumber` string, required
          - `bankName` string, required
          - `bankAddress` string, required
          - `swiftCode` string
          - `routingNumber` string, required
          - `supportedCurrencies` V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsInstructionsItemsOneOf0SupportedCurrenciesItems[], required — Currencies this wire instruction accepts
        - V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsInstructionsItems1
          - `chain` 'arbitrum' | 'avalanche' | 'base' | 'ethereum' | 'immutable' | 'monad' | 'polygon-pos' | 'solana', required — Route chain (kebab-case). Restricted to chains Agora supports for routes (EVM + Solana).
          - `depositAddress` string, required
          - `supportedCurrencies` V0RoutesGetResponsesContentApplicationJsonSchemaDataItemsInstructionsItemsOneOf1SupportedCurrenciesItems[], required — Currencies the deposit address accepts
  - `nextCursor` string, nullable, required — Opaque cursor for the next page. Pass back verbatim as the `cursor` query param to fetch the next page; null when no more results.

## Other responses

- `400` — One or more request parameters are invalid.
- `401` — Authentication is required.
- `403` — The account is not eligible for the requested route direction.
- `404` — Resource not found.
- `429` — Too many requests.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/agora/apis/endpoints.md) · [All operations](https://skmtc.net/agora/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agora/endpoints/revisions/8525bfff7634/schema)