Skip to main content
İl ve ilçe lookup’ları; merchant onboarding ve adres formlarında dropdown doldurmak için kullanılır. Sayfalama yoktur — tüm il/ilçe listesi tek seferde döner.

​
Şehirler

GET /api/v1/lookups/cities

curl https://identity.payven.com.tr/api/v1/lookups/cities \
  -H "Authorization: Bearer $PAYVEN_TOKEN"
Yanıt — şehir listesi (81 il): 
[
  { "id": "abc-...", "code": "34", "name": "İstanbul" },
  { "id": "def-...", "code": "06", "name": "Ankara" },
  { "id": "ghi-...", "code": "35", "name": "İzmir" }
]
AlanAçıklama
idUUID — districts sorgusunda kullanılır
codePlaka kodu (34, 06, …)
nameTürkçe isim

​
İlçeler

GET /api/v1/lookups/districts?city_id={uuid}
İlçeleri şehir bazında çekersiniz. Tüm ilçeleri tek seferde almak mümkün ama 950+ kayıt — seçilen şehre göre lazy-load önerilir. 
curl "https://identity.payven.com.tr/api/v1/lookups/districts?city_id=abc-..." \
  -H "Authorization: Bearer $PAYVEN_TOKEN"

[
  { "id": "...", "name": "Kadıköy",   "city_id": "abc-..." },
  { "id": "...", "name": "Beşiktaş", "city_id": "abc-..." },
  { "id": "...", "name": "Şişli",     "city_id": "abc-..." }
]
Query parametresiTipAçıklama
city_idUUIDFiltre — boş bırakılırsa tüm ilçeler döner

​
Caching

Bu liste çok nadir değişir (yeni ilçe atanması nadirdir). İstemcinizde 7 günlük cache uygulayabilirsiniz.