---
title: "Retrieve All Countries in Nexus"
method: GET
path: "/v1/countries"
tags: ["Countries & Currencies"]
---

# Retrieve All Countries in Nexus

`GET /v1/countries`

Returns all countries available on the Nexus network, along with key reference data for sending payments to those countries, such as minimum and maximum transaction amounts per currency, currency names and decimal places, requirements for message elements, the country level SLA with maximum execution timeouts as ISO 8601 durations, and the supported instruction priorities. Where a country has more than one IPS, the sla carries the most relaxed timeout across those IPSs and supportedInstructionPriorities carries the union of priorities across those IPSs. Used by: Payment Service Providers (PSPs)

## Response `200`

A list of countries with payment details.

- object
  - `countries` CountryDto[], required
    - `countryId` integer, required — ISO 3166 numeric country code.
    - `countryCode` string, required — ISO 3166 alpha 2 country code.
    - `name` string, required
    - `currencies` CountryCurrencyDto[], required
      - `currencyCode` string, required — ISO 4217 currency code, three uppercase letters.
      - `currencyName` string, required — ISO 4217 currency name.
      - `decimalPlaces` integer, required — Number of decimal places used by the currency.
      - `minAmount` string — Minimum transaction amount in this currency. Omitted when the country does not set a minimum.
      - `maxAmount` string, required — Maximum transaction amount in this currency.
    - `requiredMessageElements` object — Message elements that the country requires per API or message type, keyed by message name such as getQuotes or pacs008.
    - `sla` CountrySlaDto, required — Country level maximum execution timeouts as ISO 8601 durations. Where a country has more than one IPS with different SLAs, the country level value carries the most relaxed timeout, meaning the longest, across those IPSs. The source side timer therefore waits for the slowest destination IPS before triggering the source timeout, giving the transaction the maximum chance to succeed before any timeout path is taken.
      - `normalPaymentMaxExecutionTimeout` string, duration, required — Maximum end to end execution time for NORM priority payments.
      - `highPaymentMaxExecutionTimeout` string, duration — Maximum end to end execution time for HIGH priority payments. Present only when the country supports the HIGH priority.
    - `supportedInstructionPriorities` string[], required — The union of instruction priorities available in this country across all of its IPSs. If one IPS supports NORM and HIGH and another supports only NORM, the country advertises both NORM and HIGH.

## Other responses

- `400` — Invalid request. Reason code TE001 INVALID_REQUEST.
- `401` — Authentication failed. Applicable reason codes: AE001 AUTH_TOKEN_MISSING, AE002 AUTH_TOKEN_INVALID.
- `403` — Authorization failed. The token is valid but its OAuth2 scopes do not grant access to this endpoint or corridor. Reason code AE004 ACCESS_DENIED.
- `429` — Rate limit exceeded. Returned by the API gateway and carries no structured Nexus body. The Retry-After response header indicates when to retry.
- `500` — An unhandled exception or infrastructure failure occurred. Reason code TE099 INTERNAL_ERROR. The caller may retry with exponential backoff.

---

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