Skip to main content
GET
List countries
Stable since 2025-01-01 — unchanged in 2026-06-01.

Authorizations

Authorization
string
header
required

Access token from POST /auth (the data.access_token value).

x-api-key
string
header
required

API key issued by Kira. Required on every request, including /auth.

Headers

X-Api-Version
string

Optional. The date-versioned API version to apply for this request (e.g. 2026-04-14). When sent it always wins, even over your pinned account default. When omitted, the API uses your account's pinned version if set, otherwise a baseline default.

Example:

"2026-06-01"

Response

Success.

count
integer
required

Number of countries in data.

Example:

250

data
object[]
required

Array of supported countries. Via GET /v1/countries: each item is {name, alpha3 (ISO 3166-1 alpha-3), postal_code_format, subdivisions}, where subdivisions is an array of {name, code} (states/provinces) — e.g. Afghanistan returns alpha3: "AFG", postal_code_format: "\\A\\d{4}\\Z", and 34 subdivisions.