Turkey Postal Code API
Turkey Postal Code API provides structured JSON for Turkish addressing: provinces (81 il, plate order 1–81), districts (ilçe), and paginated address lines with neighbourhood, street, and postal code fields. A dedicated search endpoint supports partial postal code input for autocomplete and validation flows. Optional query parameter include=plaka,phone enriches responses with official vehicle…
Turkey Postal Code API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Postal code | ||
| GET |
postal_iller_v1_postal_iller_get /v1/postal/iller |
Returns all Turkish provinces (plate codes 1–81). Optional `include=plaka,phone` adds official vehicle plate prefix and/or landline area code(s) per province (Istanbul returns… |
| GET |
postal_search_v1_postal_search_get /v1/postal/search |
Partial match search on postal codes (at least 2 characters in `q`). Useful for autocomplete and validation flows. |
| GET |
postal_meta_v1_postal_meta_get /v1/postal/meta |
Returns whether the postal SQLite snapshot is loaded (`ready`), row counts, and sync/version hints. Call this first to verify the server is ready before using `/iller`, `/lines`,… |
| GET |
postal_lines_v1_postal_lines_get /v1/postal/lines |
Returns paginated street-level rows (neighbourhood, street, postal code) for a province + district pair. Use `offset`/`limit` to walk large districts. |
| GET |
postal_ilceler_v1_postal_ilceler__il_kodu__get /v1/postal/ilceler/{il_kodu} |
Lists districts (`ilceler`) for the given province code. `il_kodu` is the official 1–81 province id (same order as vehicle plates). |
Turkey Postal Code API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $2.99 / month | 5 / second |
|
| ULTRA | $5.99 / month | 10 / second |
|
| MEGA | $9.99 / month | 20 / second |
|