Search countries by name
Returns every country whose name contains the given value (case-insensitive).
Returns every country whose name contains the given value (case-insensitive).
Path Parameters
name*string
Full or partial country name.
Response Body
application/json
text/plain
curl -X GET "https://example.com/name/israel"[ { "name": "Israel", "topLevelDomain": [ ".il" ], "alpha2Code": "IL", "alpha3Code": "ISR", "callingCodes": [ "972" ], "capital": "Jerusalem", "altSpellings": [ "string" ], "subregion": "Western Asia", "region": "Asia", "population": 9216900, "latlng": [ 31.5, 34.75 ], "demonym": "Israeli", "area": 20770, "timezones": [ "UTC+02:00" ], "borders": [ "EGY", "JOR", "LBN", "SYR" ], "nativeName": "ישראל", "numericCode": "376", "flags": { "svg": "http://example.com", "png": "http://example.com" }, "currencies": [ { "code": "ILS", "name": "Israeli new shekel", "symbol": "₪" } ], "languages": [ { "iso639_1": "he", "iso639_2": "heb", "name": "Hebrew", "nativeName": "עברית" } ], "flag": "🇮🇱", "maps": { "googleMaps": "http://example.com", "openStreetMaps": "http://example.com" }, "populationDensity": 443.6 }]"Country not found"Rate limits & caching
countries.dev has no per-key rate limits or quotas — only a generous abuse ceiling. Responses are cached at the edge for speed. Learn the Cache-Control headers and how to cache in your app.
Get a country by ISO alpha code GET
Returns a single country matching the given ISO 3166-1 alpha-2 or alpha-3 code (case-insensitive).