List countries
List the reference catalog of countries Kira recognizes, with ISO alpha-3 codes, postal-code format patterns, and subdivisions (states/provinces). Use it to populate country/subdivision pickers and to validate address_country / nationality values before submitting users and recipients.
The response is a { count, data } envelope: count is the number of entries and data[] holds the countries.
Path matters: it is exactly /v1/countries. /countries and /api/countries return 403.
Authorizations
Access token from POST /auth (the data.access_token value).
API key issued by Kira. Required on every request, including /auth.
Headers
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.
"2026-06-01"
Response
Success.
Number of countries in data.
250
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.