Vergi Dairesi API

Fatura ve kayıt formlarındaki vergi dairesi seçimi için GİB'in resmî listesi; il ve ilçeye göre.

Ücretsiz pakette var JSON · Türkçe2 uç Kaynak: Gelir İdaresi Başkanlığı (gib.gov.tr)

/v1/vergi/daireler il, ilçe ve ada göre vergi dairelerini döndürür: muhasebe birim kodu, ad, tür (müdürlük, şube, defterdarlık), il ve ilçe. /v1/vergi/daireler/{kod} beş haneli koddan daireyi bulur. Liste GİB'in Defterdarlık ve Vergi Daireleri Listesi'nden derlenmiştir.

Büyükşehirlerde merkezdeki daireler birden çok ilçeye hizmet verir. İlçeye göre sorguda önce o ilçenin kendi dairesi, yoksa adında ilçe geçen merkez dairesi, o da yoksa il merkezindeki daireler döner; eslesme alanı hangisi olduğunu söyler.

Hızlı başlangıç

Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al). Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.

<?php
$ch = curl_init('https://api.veriapi.pro/v1/vergi/daireler?il=duzce');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);

const yanit = await fetch("https://api.veriapi.pro/v1/vergi/daireler?il=duzce", {
  headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);

import requests

r = requests.get("https://api.veriapi.pro/v1/vergi/daireler?il=duzce",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])

curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/vergi/daireler?il=duzce"

Örnek yanıt

GET https://api.veriapi.pro/v1/vergi/daireler?il=duzce — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "adet": 8,
    "daireler": [
      {
        "kod": "81260",
        "ad": "Düzce Vergi Dairesi Müdürlüğü",
        "tur": "mudurluk",
        "plaka": 81,
        "il": "Düzce",
        "il_slug": "duzce",
        "ilce": null,
        "ilce_slug": null,
        "merkez": true,
        "tur_adi": "Vergi dairesi müdürlüğü"
      },
      {
        "kod": "81261",
        "ad": "Akçakoca Vergi Dairesi Müdürlüğü",
        "tur": "mudurluk",
        "plaka": 81,
        "il": "Düzce",
        "il_slug": "duzce",
        "ilce": "Akçakoca",
        "ilce_slug": "duzce-akcakoca",
        "merkez": false,
        "tur_adi": "Vergi dairesi müdürlüğü"
      },
      {
        "kod": "81262",
        "ad": "Gölyaka Vergi Dairesi Müdürlüğü",
        "tur": "mudurluk",
        "plaka": 81,
        "il": "Düzce",
        "il_slug": "duzce",
        "ilce": "Gölyaka",
        "ilce_slug": "duzce-golyaka",
        "merkez": false,
        "tur_adi": "Vergi dairesi müdürlüğü"
      },
      "… 5 öğe daha"
    ]
  },
  "kaynak": [
    {
      "kod": "gib",
      "ad": "Gelir İdaresi Başkanlığı (gib.gov.tr)",
      "lisans": "Kamu kurumunun herkese açık yayımladığı liste (olgu verisi)",
      "atif": "Vergi daireleri: GİB Defterdarlık ve Vergi Daireleri Listesi (https://www.gib.gov.tr)",
      "url": "https://www.gib.gov.tr/yardim-ve-kaynaklar/vergi-dairesi-listesi"
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

GET /v1/vergi/daireler ücretsiz pakette 1 birim

Vergi daireleri ve muhasebe birim kodları (GİB; il / ilçe / ad)

Parametre	Tür	Açıklama
il	metin	İl adı ya da plaka
ilce	metin	İlçe adı (büyükşehirde merkez daireleri de bakılır)
ara	metin	Ad, ilçe ya da kod
tur	metin

GET /v1/vergi/daireler/{kod} ücretsiz pakette 1 birim

Muhasebe birim koduna göre vergi dairesi

Parametre	Tür	Açıklama
kod*	metin

Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir. Tüm parametreler: OpenAPI belgesi.

Nerelerde kullanılır?

✓E-fatura ve üyelik formlarında vergi dairesi açılır listesi
✓Muhasebe programlarında cari kartı
✓VKN doğrulamasıyla birlikte firma bilgisi

Kaynak ve lisans

Gelir İdaresi Başkanlığı (gib.gov.tr) · Kamu kurumunun herkese açık yayımladığı liste (olgu verisi) · kaynak
Atıf: Vergi daireleri: GİB Defterdarlık ve Vergi Daireleri Listesi (https://www.gib.gov.tr)

Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.

Sık sorulan sorular

Vergi dairesi API'si ücretsiz mi?

Evet; her pakette açıktır, istek başına 1 birim.

Şubelerin kodu neden yok?

GİB listesinde şubelerin muhasebe birim kodu yer almaz; şubeler bağlı oldukları müdürlüğün koduyla işlem görür.

Bir firmanın vergi dairesini bulur mu?

Hayır; mükellef sorgusu GİB'in kendi sistemindedir. Bu uç dairelerin listesini verir; VKN algoritma kontrolü için /v1/dogrula/vkn kullanılır.

Bu sayfa şu aramalar için de: vergi dairesi listesi json · vergi dairesi kodları · il ilçe vergi dairesi · muhasebe birim kodu