Get supported countries for address

Retrieve the list of countries supported for recipient addresses in international transfers. Countries with administrative divisions include a states array; countries without return an empty array.

GET/v1/transfer/supported-countries-for-address

Query Parameters

Filter by two-letter ISO 3166-1 alpha-2 country code (case-insensitive).

Filter by country name (case-insensitive partial match).

Responses

Status	Description
`200`	List of supported countries
`400`	Bad request

200 response

Array of supported countries.

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

Full country name.

Administrative divisions of the country. Returns an empty array for countries without divisions.

State or region code.

State or region name.

{
"data": {
"countries": [
  {
    "iso_code": "NG",
    "name": "Nigeria",
    "states": [
      {
        "code": "NG-LA",
        "name": "Lagos"
      },
      {
        "code": "NG-FC",
        "name": "Federal Capital Territory"
      }
    ]
  },
  {
    "iso_code": "GH",
    "name": "Ghana",
    "states": [
      {
        "code": "GH-AA",
        "name": "Greater Accra"
      },
      {
        "code": "GH-AH",
        "name": "Ashanti"
      }
    ]
  },
  {
    "iso_code": "US",
    "name": "United States",
    "states": [
      {
        "code": "US-NY",
        "name": "New York"
      },
      {
        "code": "US-CA",
        "name": "California"
      }
    ]
  },
  {
    "iso_code": "CI",
    "name": "Côte d'Ivoire",
    "states": []
  },
  {
    "iso_code": "JP",
    "name": "Japan",
    "states": []
  }
]
},
"error": null
}

400 response

{
"data": null,
"error": "invalid request payload"
}

Authorization

ApiKeyAuth

Was this page helpful?