Countries API - Retrieve Global Countries Data
Use the Countries API to retrieve country information, ISO country codes, capitals, regions, subregions, phone codes, currencies, and other geographical metadata through a simple and developer-friendly API. This API enables applications to fetch structured country datasets for global platforms, travel services, analytics systems, ecommerce applications, localization workflows, SaaS products, and GIS-based solutions.
Use it to build country dropdowns, international onboarding systems, geo-targeted applications, region-based filtering, global business platforms, localization engines, shipping systems, travel applications, and country intelligence tools.
10K Free Credits, No Credit Card Required
Features
Comprehensive Country Dataset
Access structured country-level geographical information including country names, ISO 3166 codes, capitals, regions, subregions, currencies, phone codes, nationalities, and top-level domains.
Region & Subregion Filtering
Retrieve countries belonging to specific regions and subregions for geo-based filtering, regional segmentation, and analytics workflows.
ISO Country Code Support
Work with ISO alpha-2, alpha-3, and numeric country codes for standardized international compatibility across platforms and databases.
Detailed Country Data Retrieval
Fetch detailed country information including currencies, symbols, capitals, phone prefixes, nationalities, flag emoji, and official country identifiers.
Multiple Response Formats
Supports both json and xml response formats for compatibility with modern applications and enterprise integrations.
Fast Global Country Lookup
Retrieve country records quickly for international applications, onboarding systems, and global search experiences.
Localization & Internationalization Ready
Use country data to power localization workflows, multi-country applications, language systems, payment flows, and region-aware user experiences.
API Endpoints
Countries List API
Retrieve a complete list of countries with ISO codes, capitals, regions, and subregions. Use the optional region and subregion parameters to filter results.
Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.
LANGUAGE
$ pip install requestsimport requests
url = "https://api.apifreaks.com/v1.0/geo/countries?region=Europe"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
Country Details API
Retrieve detailed metadata for a specific country using its ISO 3166-1 alpha-2 code, including currency, phone code, nationality, flag emoji, native name, and top-level domain.
Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.
LANGUAGE
$ pip install requestsimport requests
url = "https://api.apifreaks.com/v1.0/geo/country/details?country=UK"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
How-to Guides
Complete Countries List
Retrieve a complete list of all countries along with their ISO codes, capitals, regions, and subregions.
# Response { "countries": [ { "name": "Andorra", "iso_alpha_2": "AD", "iso_alpha_3": "AND", "iso_numeric": 20, "capital": "Andorra la Vella", "region": "Europe", "subregion": "Southern Europe" }, { "name": "United Arab Emirates", "iso_alpha_2": "AE", "iso_alpha_3": "ARE", "iso_numeric": 784, "capital": "Abu Dhabi", "region": "Asia", "subregion": "Western Asia" }, { "name": "Afghanistan", "iso_alpha_2": "AF", "iso_alpha_3": "AFG", "iso_numeric": 4, "capital": "Kabul", "region": "Asia", "subregion": "Southern Asia" }, { "name": "Albania", "iso_alpha_2": "AL", "iso_alpha_3": "ALB", "iso_numeric": 8, "capital": "Tirana", "region": "Europe", "subregion": "Southern Europe" } ] }curl -X 'GET' 'https://api.apifreaks.com/v1.0/geo/countries?apiKey=API-KEY'
Filter Countries by Region
Use the region and optional subregion parameters to narrow countries to a specific geographic area.
# Response { "countries": [ { "name": "Andorra", "iso_alpha_2": "AD", "iso_alpha_3": "AND", "iso_numeric": 20, "capital": "Andorra la Vella", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Albania", "iso_alpha_2": "AL", "iso_alpha_3": "ALB", "iso_numeric": 8, "capital": "Tirana", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Austria", "iso_alpha_2": "AT", "iso_alpha_3": "AUT", "iso_numeric": 40, "capital": "Vienna", "region": "Europe", "subregion": "Western Europe" }, { "name": "Aland Islands", "iso_alpha_2": "AX", "iso_alpha_3": "ALA", "iso_numeric": 248, "capital": "Mariehamn", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Bosnia and Herzegovina", "iso_alpha_2": "BA", "iso_alpha_3": "BIH", "iso_numeric": 70, "capital": "Sarajevo", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Belgium", "iso_alpha_2": "BE", "iso_alpha_3": "BEL", "iso_numeric": 56, "capital": "Brussels", "region": "Europe", "subregion": "Western Europe" }, { "name": "Bulgaria", "iso_alpha_2": "BG", "iso_alpha_3": "BGR", "iso_numeric": 100, "capital": "Sofia", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Belarus", "iso_alpha_2": "BY", "iso_alpha_3": "BLR", "iso_numeric": 112, "capital": "Minsk", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Switzerland", "iso_alpha_2": "CH", "iso_alpha_3": "CHE", "iso_numeric": 756, "capital": "Bern", "region": "Europe", "subregion": "Western Europe" }, { "name": "Cyprus", "iso_alpha_2": "CY", "iso_alpha_3": "CYP", "iso_numeric": 196, "capital": "Nicosia", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Czech Republic", "iso_alpha_2": "CZ", "iso_alpha_3": "CZE", "iso_numeric": 203, "capital": "Prague", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Germany", "iso_alpha_2": "DE", "iso_alpha_3": "DEU", "iso_numeric": 276, "capital": "Berlin", "region": "Europe", "subregion": "Western Europe" }, { "name": "Denmark", "iso_alpha_2": "DK", "iso_alpha_3": "DNK", "iso_numeric": 208, "capital": "Copenhagen", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Estonia", "iso_alpha_2": "EE", "iso_alpha_3": "EST", "iso_numeric": 233, "capital": "Tallinn", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Spain", "iso_alpha_2": "ES", "iso_alpha_3": "ESP", "iso_numeric": 724, "capital": "Madrid", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Finland", "iso_alpha_2": "FI", "iso_alpha_3": "FIN", "iso_numeric": 246, "capital": "Helsinki", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Faroe Islands", "iso_alpha_2": "FO", "iso_alpha_3": "FRO", "iso_numeric": 234, "capital": "Torshavn", "region": "Europe", "subregion": "Northern Europe" }, { "name": "France", "iso_alpha_2": "FR", "iso_alpha_3": "FRA", "iso_numeric": 250, "capital": "Paris", "region": "Europe", "subregion": "Western Europe" }, { "name": "United Kingdom", "iso_alpha_2": "GB", "iso_alpha_3": "GBR", "iso_numeric": 826, "capital": "London", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Guernsey", "iso_alpha_2": "GG", "iso_alpha_3": "GGY", "iso_numeric": 831, "capital": "St Peter Port", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Gibraltar", "iso_alpha_2": "GI", "iso_alpha_3": "GIB", "iso_numeric": 292, "capital": "Gibraltar", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Greece", "iso_alpha_2": "GR", "iso_alpha_3": "GRC", "iso_numeric": 300, "capital": "Athens", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Croatia", "iso_alpha_2": "HR", "iso_alpha_3": "HRV", "iso_numeric": 191, "capital": "Zagreb", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Hungary", "iso_alpha_2": "HU", "iso_alpha_3": "HUN", "iso_numeric": 348, "capital": "Budapest", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Ireland", "iso_alpha_2": "IE", "iso_alpha_3": "IRL", "iso_numeric": 372, "capital": "Dublin", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Man (Isle of)", "iso_alpha_2": "IM", "iso_alpha_3": "IMN", "iso_numeric": 833, "capital": "Douglas, Isle of Man", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Iceland", "iso_alpha_2": "IS", "iso_alpha_3": "ISL", "iso_numeric": 352, "capital": "Reykjavik", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Italy", "iso_alpha_2": "IT", "iso_alpha_3": "ITA", "iso_numeric": 380, "capital": "Rome", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Jersey", "iso_alpha_2": "JE", "iso_alpha_3": "JEY", "iso_numeric": 832, "capital": "Saint Helier", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Liechtenstein", "iso_alpha_2": "LI", "iso_alpha_3": "LIE", "iso_numeric": 438, "capital": "Vaduz", "region": "Europe", "subregion": "Western Europe" }, { "name": "Lithuania", "iso_alpha_2": "LT", "iso_alpha_3": "LTU", "iso_numeric": 440, "capital": "Vilnius", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Luxembourg", "iso_alpha_2": "LU", "iso_alpha_3": "LUX", "iso_numeric": 442, "capital": "Luxembourg", "region": "Europe", "subregion": "Western Europe" }, { "name": "Latvia", "iso_alpha_2": "LV", "iso_alpha_3": "LVA", "iso_numeric": 428, "capital": "Riga", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Monaco", "iso_alpha_2": "MC", "iso_alpha_3": "MCO", "iso_numeric": 492, "capital": "Monaco", "region": "Europe", "subregion": "Western Europe" }, { "name": "Moldova", "iso_alpha_2": "MD", "iso_alpha_3": "MDA", "iso_numeric": 498, "capital": "Chisinau", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Montenegro", "iso_alpha_2": "ME", "iso_alpha_3": "MNE", "iso_numeric": 499, "capital": "Podgorica", "region": "Europe", "subregion": "Southern Europe" }, { "name": "North Macedonia", "iso_alpha_2": "MK", "iso_alpha_3": "MKD", "iso_numeric": 807, "capital": "Skopje", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Malta", "iso_alpha_2": "MT", "iso_alpha_3": "MLT", "iso_numeric": 470, "capital": "Valletta", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Netherlands", "iso_alpha_2": "NL", "iso_alpha_3": "NLD", "iso_numeric": 528, "capital": "Amsterdam", "region": "Europe", "subregion": "Western Europe" }, { "name": "Norway", "iso_alpha_2": "NO", "iso_alpha_3": "NOR", "iso_numeric": 578, "capital": "Oslo", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Poland", "iso_alpha_2": "PL", "iso_alpha_3": "POL", "iso_numeric": 616, "capital": "Warsaw", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Portugal", "iso_alpha_2": "PT", "iso_alpha_3": "PRT", "iso_numeric": 620, "capital": "Lisbon", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Romania", "iso_alpha_2": "RO", "iso_alpha_3": "ROU", "iso_numeric": 642, "capital": "Bucharest", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Serbia", "iso_alpha_2": "RS", "iso_alpha_3": "SRB", "iso_numeric": 688, "capital": "Belgrade", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Russia", "iso_alpha_2": "RU", "iso_alpha_3": "RUS", "iso_numeric": 643, "capital": "Moscow", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Sweden", "iso_alpha_2": "SE", "iso_alpha_3": "SWE", "iso_numeric": 752, "capital": "Stockholm", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Slovenia", "iso_alpha_2": "SI", "iso_alpha_3": "SVN", "iso_numeric": 705, "capital": "Ljubljana", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Svalbard and Jan Mayen Islands", "iso_alpha_2": "SJ", "iso_alpha_3": "SJM", "iso_numeric": 744, "capital": "Longyearbyen", "region": "Europe", "subregion": "Northern Europe" }, { "name": "Slovakia", "iso_alpha_2": "SK", "iso_alpha_3": "SVK", "iso_numeric": 703, "capital": "Bratislava", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "San Marino", "iso_alpha_2": "SM", "iso_alpha_3": "SMR", "iso_numeric": 674, "capital": "San Marino", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Ukraine", "iso_alpha_2": "UA", "iso_alpha_3": "UKR", "iso_numeric": 804, "capital": "Kyiv", "region": "Europe", "subregion": "Eastern Europe" }, { "name": "Vatican City State (Holy See)", "iso_alpha_2": "VA", "iso_alpha_3": "VAT", "iso_numeric": 336, "capital": "Vatican City", "region": "Europe", "subregion": "Southern Europe" }, { "name": "Kosovo", "iso_alpha_2": "XK", "iso_alpha_3": "XKX", "iso_numeric": 926, "capital": "Pristina", "region": "Europe", "subregion": "Eastern Europe" } ] }curl -X 'GET' 'https://api.apifreaks.com/v1.0/geo/countries?region=Europe&subregion=Northern+Europe&apiKey=API-KEY'
Details of a Country
Retrieve detailed metadata for a country using its ISO 3166-1 alpha-2 code, including currency, phone code, nationality, and flag emoji.
# Response { "name": "United Kingdom", "iso_alpha_2": "GB", "iso_alpha_3": "GBR", "iso_numeric": 826, "phone_code": 44, "capital": "London", "top_level_domain": ".uk", "native_name": "United Kingdom", "region": "Europe", "subregion": "Northern Europe", "nationality": "British, UK", "flag_emoji": "🇬🇧", "currency_code": "GBP", "currency_name": "British pound", "currency_symbol": "£" }curl -X 'GET' 'https://api.apifreaks.com/v1.0/geo/country/details?country=GB&apiKey=API-KEY'
Frequently Asked Questions
A Countries API allows applications to retrieve country-related geographical data such as country names, ISO country codes, capitals, regions, subregions, currencies, and other metadata through REST endpoints. It eliminates the need to maintain static country datasets in your codebase
Yes. The Country Details endpoint returns currency_code, currency_name, currency_symbol, and phone_code for each country. This is useful for ecommerce systems, international payment flows, fintech applications, and global communication platforms.
Yes. The Country Details endpoint returns
currency_code, currency_name, currency_symbol, and phone_code for each country. This is useful for ecommerce systems, international payment flows, fintech applications, and global communication platforms.Yes. The Countries List endpoint supports filtering by both
region and subregion. This is useful for geo-targeted applications, regional analytics, localization systems, and continent-based filtering workflows.Countries APIs are commonly used in ecommerce platforms, travel applications, GIS systems, localization workflows, analytics platforms, onboarding systems, CRM applications, shipping software, geo-targeted services, and global SaaS products that require structured country and regional data.
Pricing
To use the Countries API, you will need API credits. We only charge for successful queries, defined by a 2xx status code. If your request results in a 4xx or 5xx status code, no credits will be charged, and any deducted credits will be returned.
For each successful request, 1 credit will be charged.
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.