> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField header="Authorization" type="string" required>
  Bearer token (for example <code>Authorization: Bearer YOUR\_API\_KEY</code>)
</ParamField>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "items": [
      {
        "name": "Afghanistan",
        "code": "AF",
        "region": "as",
        "slug": "afghanistan"
      },
      {
        "name": "Albania",
        "code": "AL",
        "region": "eu",
        "slug": "albania"
      }
    ]
  }
  ```
</ResponseExample>

`region` uses the accounting region codes documented in the accompanying [/v1/ref/regions](./regions) endpoint.