Countries API with ISO codes, currencies and calling codes
Every country as a clean JSON profile: ISO codes, official and native names, capital, currencies, languages, calling code and region.
What it does
ISO country profiles with capitals, currencies, languages, and calling codes. Turkey's 81 provinces and 973 districts use stable ids such as TR-34 and TR-34-KADIKOY.
- GET /v1/countries
- GET /v1/countries/{code}
- GET /v1/countries/{code}/divisions
- GET /v1/divisions/{id}
- GET /v1/divisions/{id}/children
Limits: Province and district lists cover Turkey only. No neighbourhoods (mahalle) or population statistics. Postal codes have their own endpoint.
Use cases
- Build country pickers with flags, calling codes and currencies.
- Validate ISO 3166-1 alpha-2 and alpha-3 codes.
- Localize forms with native and Turkish country names.
Data sources and freshness
The world-countries dataset (ODbL), plus OpenStreetMap for Turkish districts.
Country data changes rarely and is updated with each release.
Pricing
Every new account gets 100 free calls. Packs of 10,000 ($5), 100,000 ($15) and 250,000 calls ($29) never expire, or choose Unlimited for $39 a month. Only successful responses use a call. See pricing.
FAQ
Which country codes are supported?
ISO 3166-1 alpha-2 codes such as TR, DE and US. GET /v1/countries lists all countries and GET /v1/countries/{code} returns one.
Does it include provinces or states?
Subdivisions are included for Turkey: 81 provinces and 973 districts with stable ids. Other countries return the country profile only.