Vergi Hesaplama API

KDV, tevkifat, stopaj, damga vergisi ve maaş hesabı; her yanıtta o tarihte yürürlükteki kural ve dayanağı.

Ücretsiz pakette var JSON · Türkçe11 uç Kaynak: Resmî Gazete / mevzuat

Vergi kuralları sürümlüdür: her oran ve tutar yürürlük başlangıcı, bitişi ve Resmî Gazete dayanağıyla tutulur. Hesap uçlarına tarih gönderirseniz o gün geçerli kuralla hesaplanır (ör. 2025'te değişen beyanname damga vergisi tutarları); yanıttaki surum alanı hangi kuralın kullanıldığını gösterir. /v1/vergi/kurallar tüm sürümleri listeler.

/v1/vergi/kdv KDV hariç ve dahil tutarlar arasında çevirir, tevkifat kodu verilirse kısmi tevkifatı (4/10, 9/10…) fatura sınırıyla birlikte uygular. /v1/vergi/stopaj GVK 94 kesintisini brütten nete ya da netten brüte hesaplar. /v1/vergi/damga nispi kağıtta azami tutarı, maktu kağıtta güncel tutarı verir. /v1/vergi/maas sabit brütle 12 aylık bordroyu (SGK tavanı, kümülatif vergi dilimi, asgari ücret istisnası, engellilik indirimi) çıkarır.

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/kdv?tutar=100000&oran=20&tevkifat=yapim');
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/kdv?tutar=100000&oran=20&tevkifat=yapim", {
  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/kdv?tutar=100000&oran=20&tevkifat=yapim",
                 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/kdv?tutar=100000&oran=20&tevkifat=yapim"

Örnek yanıt

GET https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "tarih": "2026-11-02",
    "oran": 20.0,
    "kdv_dahil_girildi": false,
    "matrah": 100000.0,
    "kdv": 20000.0,
    "toplam": 120000.0,
    "surum": {
      "baslangic": "2023-07-10",
      "bitis": null,
      "dayanak": "7346 sayılı Cumhurbaşkanı Kararı, Resmî Gazete 07.07.2023"
    },
    "tevkifat": {
      "kod": "yapim",
      "ad": "Yapım işleri ve birlikte ifa edilen mühendislik-mimarlık, etüt-proje",
      "oran": "4/10",
      "tevkif_edilen_kdv": 8000.0,
      "saticiya_odenecek_kdv": 12000.0,
      "saticiya_odenecek_toplam": 112000.0,
      "sinir_alti": false,
      "sinir_kdv_dahil": 12000.0,
      "surum": {
        "baslangic": "2026-01-01",
        "bitis": null,
        "dayanak": "KDV Genel Uygulama Tebliği I/C-2.1.3 (oranlar: GİB kısmi tevkifat tablosu); sınır: VUK 232 fatura düzenleme sınırı, 588 Sıra No VUK Genel Tebliği, Resmî Gaze…"
      }
    }
  },
  "kaynak": [
    {
      "kod": "mevzuat",
      "ad": "Resmî Gazete / mevzuat",
      "lisans": "FSEK m.31 (yayımlanmış mevzuat)",
      "atif": "Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)",
      "url": "https://www.resmigazete.gov.tr/"
    },
    {
      "kod": "hesap",
      "ad": "VeriApi.Pro hesaplaması",
      "lisans": "VeriApi.Pro",
      "atif": "VeriApi.Pro tarafından hesaplanmıştır",
      "url": null
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

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

Sürümlü vergi kuralları (yürürlük tarihi ve dayanağıyla)

GET /v1/vergi/kdv ücretli paket 1 birim

KDV hesabı (dahil ↔ hariç) ve kısmi tevkifat

ParametreTürAçıklama
tutar* sayı
oran sayı varsayılan: 20
dahil evet/hayır Tutar KDV dahil mi varsayılan: False
tevkifat metin Tevkifat kalemi kodu (/v1/vergi/kdv/tevkifat)
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/kdv/oranlar ücretsiz pakette 1 birim

Tarihte geçerli KDV oranları

ParametreTürAçıklama
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/kdv/tevkifat ücretsiz pakette 1 birim

KDV kısmi tevkifat kalemleri ve sınır

ParametreTürAçıklama
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/stopaj ücretli paket 1 birim

Stopaj (GVK 94): brütten nete, netten brüte

ParametreTürAçıklama
tutar* sayı
tur* metin Kalem kodu (/v1/vergi/stopaj/oranlar)
net evet/hayır Tutar net mi (brüte iblağ) varsayılan: False
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/stopaj/oranlar ücretsiz pakette 1 birim

Stopaj oranları

ParametreTürAçıklama
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/damga ücretli paket 1 birim

Damga vergisi (nispi, azami tutar, maktu)

ParametreTürAçıklama
tur* metin Kağıt türü kodu (/v1/vergi/damga/oranlar)
tutar sayı Nispi kağıtta kağıttaki tutar
nusha tam sayı varsayılan: 1
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/damga/oranlar ücretsiz pakette 1 birim

Damga vergisi oranları ve maktu tutarlar

ParametreTürAçıklama
tarih metin Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün
GET /v1/vergi/gelir ücretsiz pakette 1 birim

Gelir vergisi tarifesi; matrah verilirse vergi

ParametreTürAçıklama
matrah sayı Yıllık vergi matrahı (TL)
tur metin varsayılan: ucret
yil tam sayı
GET /v1/vergi/mtv ücretli paket 1 birim

Motorlu Taşıtlar Vergisi (/v1/hesapla/mtv ile aynı hesap)

ParametreTürAçıklama
silindir tam sayı
yas* tam sayı
deger sayı
tescil metin varsayılan: 2018_sonrasi
tur metin varsayılan: otomobil
guc sayı
yil tam sayı
GET /v1/vergi/maas ücretli paket 2 birim

Brütten nete maaş (12 ay bordro) / netten brüte

ParametreTürAçıklama
brut sayı Aylık brüt ücret
net sayı İstenen aylık net (brüt hesaplanır)
ay tam sayı Netten brüte: hangi ayın neti (kümülatif matrah) varsayılan: 1
yil tam sayı
engelli tam sayı Engellilik derecesi (indirim)

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?

  • ✓Ön muhasebe ve e-fatura yazılımları
  • ✓Bordro ve İK uygulamaları
  • ✓Haber sitelerinde hesaplama araçları
  • ✓Serbest meslek ve kira makbuzu hesapları

Kaynak ve lisans

  • Resmî Gazete / mevzuat · FSEK m.31 (yayımlanmış mevzuat) · kaynak
    Atıf: Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)

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

Sık sorulan sorular

Mevzuat değişince ne olur?

Yeni oran yeni bir sürüm olarak eklenir; eski sürüm silinmez, geçmiş tarihli hesaplar eski kuralla yapılmaya devam eder.

Hangi uçlar ücretsiz?

Kural ve oran listeleri ile gelir vergisi tarifesi tüm paketlerde; KDV, stopaj, damga, MTV ve maaş hesaplayıcıları Başlangıç ve üstü paketlerde.

Hesaplar resmî mi?

Hayır, bilgilendirme amaçlıdır; özel durumlar (istisnalar, teşvikler, önceki işveren matrahı) için mali müşavirinize danışın.

Bu sayfa şu aramalar için de: kdv hesaplama api · tevkifat hesaplama api · stopaj hesaplama api · damga vergisi hesaplama api · brütten nete maaş api · vergi api