Skip to content

Retrieve a list of countries

Request

Provides a list of countries that are supported by Banxa. The list is the same regardless of whether a buy or sell order.

Path
partnerstringrequired

This is the partner code provided to you during onboarding. e.g. metamask.

Headers
Acceptstring
Default:"application/json"
x-api-keystring

This is the API Key that has been provided to you during onboarding.

curl -i -X GET \
  'https://docs.banxa.com/_mock/products/hosted-checkout/openapi/{partner}/v2/countries' \
  -H 'Accept: application/json' \
  -H 'x-api-key: string'

Responses

200

Bodyapplication/json
Array [
idstring
Example:"US"
descriptionstring
Example:"United States of America"
statesArray of objects
]
Response
[
  {
    "id": "US",
    "description": "United States of America",
    "states": [ … ]
  },
  {
    "id": "AE",
    "description": "United Arab Emirates",
    "states": []
  },
  {
    "id": "DE",
    "description": "Germany",
    "states": []
  }
]
© Banxa 2026