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

# Countries Dataset

> Look up countries and localization data like ISO codes, continent, population, and currency.

Use the Countries Dataset when you need localization in your product—country names, standard ISO codes, continent mapping, and currency codes. It’s especially helpful for travel apps that need to automatically display local currency or present country-aware UI.

### Authentication

**x-api-key** `string` *required*

Your FlyStack API token. You can create one from the dashboard (see [Authentication](https://docs.flystack.dev/authentication.md)).

### Query parameters

**code** `string`

Filter by country ISO-2 code (e.g., `US`).

**code3** `string`

Filter by country ISO-3 code (e.g., `USA`).

**continent** `string`

Filter by continent code: `AF`, `AN`, `AS`, `EU`, `NA`, `OC`, `SA`.

**\_fields** `string`

Comma-separated list of fields to return (e.g., `name,code,code3,currency`).

#### Pagination

**limit** `number`

Max number of rows per response: 1,000 by default, up to 10,000 (limits may depend on your plan).

**offset** `number`

Pagination offset (0+). When more rows match, the response has the headers `X-Has-More: true` and `X-Next-Offset`: pass its value as `offset` to get the next page.

### Response

The endpoint returns a list of countries.

#### Countries dataset response fields

**name** `string`

Country name.

**code** `string`

ISO-2 country code.

**code3** `string`

ISO-3 country code.

**population** `number`

Total country population (when available).

**continent** `string`

Continent code (`AF`, `AN`, `AS`, `EU`, `NA`, `OC`, `SA`).

**currency** `string`

Main currency code (when available).

**names** `object`

Alternative names in different languages (when available).

```json ?code=FR theme={null}
[
  {
    "code": "FR",
    "code3": "FRA",
    "name": "France",
    "population": 66987244,
    "continent": "EU",
    "currency": "EUR",
    "names": {
      "de": "Frankreich",
      "en": "France",
      "es": "Francia",
      "fr": "France",
      "ja": "フランス"
    }
  }
]
```

### See also

* [Airports Dataset API](https://docs.flystack.dev/api-reference/endpoints/airports.md)
* [Real-Time Flights API](https://docs.flystack.dev/api-reference/endpoints/flights.md)
* Flight Schedules API (see [Schedules](https://docs.flystack.dev/api-reference/endpoints/schedules.md))


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.