Skip to main content
GET
/
v1
/
countries
Countries Dataset
curl --request GET \
  --url https://api.flystack.dev/v1/countries \
  --header 'x-api-key: <x-api-key>'
[
  {
    "code": "US",
    "code3": "USA",
    "name": "United States",
    "population": 327167434,
    "continent": "NA",
    "currency": "USD",
    "names": {
      "en": "United States",
      "fr": "États-Unis",
      "es": "Estados Unidos"
    }
  }
]
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).

​
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).

​
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).
[
  {
    "code": "US",
    "code3": "USA",
    "name": "United States",
    "population": 327167434,
    "continent": "NA",
    "currency": "USD",
    "names": {
      "en": "United States",
      "fr": "États-Unis",
      "es": "Estados Unidos"
    }
  }
]

​
See also