---
title: "Countries"
method: GET
path: "/countries"
tags: ["reference_data"]
---

# Countries

`GET /countries`

The countries endpoint provides a comprehensive list of countries, including their ISO codes, official names, capitals, and currencies. This data is essential for applications requiring accurate country information for tasks such as localization, currency conversion, or geographic analysis.

## Response `200`

- object
  - `data` CountryResponseItem[], required — List of countries with their ISO codes, names, capital, and currency
    - `iso2` string, required — Two-letter country code defined in ISO 3166
    - `iso3` string, required — Three-letter country code defined in ISO 3166
    - `numeric` string, required — Numeric country code defined in ISO 3166
    - `name` string, required — The full name of country
    - `official_name` string, required — Official name of country
    - `capital` string, required — Capital of country
    - `currency` string, required — Currency of country

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)