Skip to content
/
Supported Countries

Supported Countries

Request

Retrieve supported countries for KYC and transaction flows as part of the configuration data required to build onboarding and transaction flows.

Use Cases:

  • Populate country dropdowns during customer onboarding
  • Determine which countries are enabled for your merchant configuration
  • Retrieve state or province options for countries that require region selection
  • Filter valid options based on customer location

Response Structure: Each country includes:

  • id: Two-letter ISO country code
  • description: Human-readable country name
  • states: List of supported states or provinces for that country, if applicable
Security
HMACAuth
curl -i -X GET \
  https://docs.banxa.com/_mock/products/native-api/openapi/eapi/v0/countries \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successful response with supported countries and their states or provinces where applicable.

Bodyapplication/json
Array [
idstring, = 2 characters(Country Code)^[A-Z]{2}$required

Two-letter ISO 3166-1 alpha-2 country code.

Example:"US"
descriptionstring(Country Name)required

Human-readable name of the country.

Example:"United States"
statesArray of objects(States or Provinces)required

List of supported states or provinces for the country. Empty when the country does not require region selection.

]
Response

Example response showing countries with and without state or province lists.

[
  {
    "id": "US",
    "description": "United States",
    "states": [ … ]
  },
  {
    "id": "CA",
    "description": "Canada",
    "states": [ … ]
  },
  {
    "id": "GB",
    "description": "United Kingdom",
    "states": []
  }
]
© Banxa 2026