Country Information
Comprehensive country information API with data for 250+ countries and territories. Look up countries by ISO 3166-1 code, search by name, or retrieve the full list. Returns detailed information including official names, capitals, regions, population, area, languages, currencies, calling codes, timezones, and flag emoji. Ideal for address forms, localization, geographic data enrichment, travel…
Country Information endpoints
| Method | Endpoint | Description |
|---|---|---|
| Lookup | ||
| GET |
lookupCountry /v1/lookup |
Returns detailed information for a country identified by its ISO 3166-1 alpha-2 code (e.g., NL, US, DE). Returns comprehensive data including official name, capital, region,… |
| Search | ||
| GET |
listAllCountries /v1/all |
Returns a summary list of all 250+ countries and territories. Each entry includes the ISO code, name, capital, region, and flag emoji. Use the /v1/lookup endpoint for full… |
| GET |
searchCountries /v1/search |
Searches for countries matching the given name query. Performs a case-insensitive partial match against country names and official names. Returns an array of matching countries… |
| Utility | ||
| GET |
getDocs /v1/docs |
Returns links to API documentation, changelog, and support resources. |
| GET |
getHealth /health |
Returns the current health status of the API. This endpoint requires no authentication and can be used for uptime monitoring. |
| Other endpoints | ||
| GET |
listAllCountries /v1/all |
Returns a summary list of all 250+ countries and territories. Each entry includes the ISO code, name, capital, region, and flag emoji. Use the /v1/lookup endpoint for full… |
| GET |
lookupCountry /v1/lookup |
Returns detailed information for a country identified by its ISO 3166-1 alpha-2 code (e.g., NL, US, DE). Returns comprehensive data including official name, capital, region,… |
| GET |
getHealth /health |
Returns the current health status of the API. This endpoint requires no authentication and can be used for uptime monitoring. |
| GET |
searchCountries /v1/search |
Searches for countries matching the given name query. Performs a case-insensitive partial match against country names and official names. Returns an array of matching countries… |
| GET |
getDocs /v1/docs |
Returns links to API documentation, changelog, and support resources. |
Country Information pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / minute |
|
| PRO | $9.99 / month | 30 / minute |
|
| ULTRA Recommended | $49.99 / month | 150 / minute |
|
| MEGA | $199 / month | 500 / minute |
|