Retrieve a list of countries

Request

Returns the countries Banxa supports, each with its id and display name, and with its states where they apply. The list is the same for buy and sell orders. See Geographic and asset restrictions for what is limited in each country.

Path

partnerstringrequired

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

Acceptstring

Default:"application/json"

x-api-keystring

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

Example:YOUR_API_KEY

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

Responses

List of supported countries.

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": []
  }
]