---
title: "Get a Route by ID"
method: GET
path: "/v0/routes/{routeId}"
tags: ["Routes"]
---

# Get a Route by ID

`GET /v0/routes/{routeId}`

<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>

Retrieve a single route by its id, including the full reusable `instructions` block. Route ids are deterministic — the same canonical inputs always derive the same id — so a `404` means no route with those parameters has been created for your organization.

## Path parameters

- `routeId` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- RoutesGetbyidResponse200
  - `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` V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaFrom, required
    - `currency` 'ausd' | 'stablecoin' | 'usd' | 'usdc', required — Currency identifier.
  - `to` V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaTo, 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` V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaInstructionsItems[], 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
      - V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaInstructionsItems0
        - `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` V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaInstructionsItemsOneOf0SupportedCurrenciesItems[], required — Currencies this wire instruction accepts
      - V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaInstructionsItems1
        - `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` V0RoutesRouteIdGetResponsesContentApplicationJsonSchemaInstructionsItemsOneOf1SupportedCurrenciesItems[], required — Currencies the deposit address accepts

## 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/versions/8525bfff7634/schema)