Get one country's currencies, routes and requirements

The country is the resource. Everything you need to move money in or out of it comes back from this one read, with no query parameters.

routes[] is the route registry. Each entry is a supported combination of currency, destination type and rail, and carries:

  • which operations it supports, PAYOUT or COLLECTION
  • the identifier fields to collect when registering a destination of that kind
  • whether a payout on it needs a quote
  • its status, one of LIVE, SANDBOX or TARGET

A combination that isn't LIVE is refused with route_unsupported before anything is locked, at registration, at quote and at payout. You'll never discover it at settlement.

Wallet destinations have no country and don't appear here. A stablecoin wallet is registered with chain and address only, and is reachable on the WALLET rail for every chain in Chain.

Read each country once when you integrate, then again whenever country.route.updated fires. Providers and account identifiers are never part of a route.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

ISO 3166-1 alpha-3, the only form Alfred stores, filters on, reports or emits. Compatibility rule for
integrations that can only send alpha-2: any inbound country value in alpha-2 (path, query or body) is
normalized to alpha-3 at the boundary before validation, storage or routing. Unrecognized in either form
→ 422 validation_error.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json