List Countries

Retrieve the canonical list of countries used across Voyant.

Method

GET /v1/ref/countries

Description

Returns the full, English-localized list of countries supported by the platform. Each entry includes the country name, ISO 3166-1 alpha-2 code, the accounting region code, and a slug. This endpoint is useful for building forms or validating country input without hardcoding values in your application.

Headers

Authorization · string · required

Bearer token (for example Authorization: Bearer YOUR_API_KEY)

Response

200 OK

{
  "items": [
    {
      "name": "Afghanistan",
      "code": "AF",
      "region": "as",
      "slug": "afghanistan"
    },
    {
      "name": "Albania",
      "code": "AL",
      "region": "eu",
      "slug": "albania"
    }
  ]
}

region uses the accounting region codes documented in the accompanying /v1/ref/regions endpoint.