Loading
Loading
Get a complete list of countries with ISO codes, capitals, currencies, languages, phone codes, and continent data.
The APIFreaks Countries API returns all available countries with their ISO codes, capital cities, regions, and subregions. You can optionally filter by region or subregion.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following optional parameters can be used to filter the countries list. Both parameters are passed as query string parameters.
regionoptionalStringOptional filter to return countries within a specific region.
subregionoptionalStringOptional filter to return countries within a specific subregion.
A successful request returns a 200 OK response with a JSON object containing the countries array.
countriesAn array of country objects matching the applied filters.
countries[].nameThe full English name of the country (e.g., "Afghanistan").
countries[].iso_alpha_2The ISO 3166-1 alpha-2 two-letter country code (e.g., "AF").
countries[].iso_alpha_3The ISO 3166-1 alpha-3 three-letter country code (e.g., "AFG").
countries[].iso_numericThe ISO 3166-1 numeric country code (e.g., 4).
countries[].capitalThe capital city of the country (e.g., "Kabul").
countries[].regionThe broad geographical region the country belongs to (e.g., "Asia", "Europe").
countries[].subregionThe more specific subregion the country belongs to (e.g., "Southern Asia", "Western Europe").
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Please provide a valid region name.
Please provide a valid subregion name.