Turkey provinces and districts API: 81 il, 973 ilçe
List Turkey's 81 provinces and the districts of each one with stable ids, Turkish names and parent links. Ideal for il/ilçe dropdowns in address forms.
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
- Cascading il → ilçe dropdowns in checkout and shipping forms.
- Normalize Turkish addresses to stable province and district ids.
- Map Turkish license plate codes (01–81) to provinces.
Data sources and freshness
Province list from ISO 3166-2:TR; district names © OpenStreetMap contributors (ODbL).
Updated when Turkey's administrative divisions change.
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
How many provinces and districts are included?
All 81 provinces (il) and 973 districts (ilçe). Province ids follow ISO 3166-2, for example TR-34 for İstanbul; district ids look like TR-34-KADIKOY.
How do I get the districts of one province?
Call GET /v1/divisions/TR-34/children. GET /v1/countries/TR/divisions lists the 81 provinces.
Does it include neighbourhoods (mahalle) or postal codes?
No. Neighbourhoods, postal codes and population figures are not included.