Hesaplama API'leri

Kredi, mevduat, MTV, tazminat ve emeklilik hesaplarını kendi formülünüzü yazmadan, güncel oranlarla yapın.

Ücretli paketlerde JSON · Türkçe8 uç Kaynak: Resmî Gazete / mevzuat, GİB Motorlu Taşıtlar Vergisi tarifesi, VeriApi.Pro hesaplaması

/v1/hesapla/kredi tutar, vade ve aylık faizden taksiti, toplam faizi, KKDF ve BSMV'yi kredi türüne göre (ihtiyaç, konut, taşıt, ticari) hesaplar ve ödeme planını döndürür. /v1/hesapla/mevduat brüt getiri, stopaj ve net kazancı verir.

/v1/hesapla/mtv motorlu taşıtlar vergisini (elektrikli araç indirimi dahil), /v1/hesapla/kidem ve /v1/hesapla/ihbar tazminatları güncel tavan ve vergilerle, /v1/hesapla/issizlik ödenek tutarını ve süresini, /v1/hesapla/emekli zam sonrası aylığı hesaplar. Oranlar mevzuat değiştikçe güncellenir; sizin kodunuz aynı kalı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/hesapla/kredi?tutar=100000&vade=12&faiz=3.5');
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/hesapla/kredi?tutar=100000&vade=12&faiz=3.5", {
  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/hesapla/kredi?tutar=100000&vade=12&faiz=3.5",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/hesapla/kredi?tutar=100000&vade=12&faiz=3.5"

Örnek yanıt

GET https://api.veriapi.pro/v1/hesapla/kredi?tutar=100000&vade=12&faiz=3.5 — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "tur": "ihtiyac",
    "tur_adi": "İhtiyaç (tüketici) kredisi",
    "tutar": 100000.0,
    "vade_ay": 12,
    "aylik_faiz": 3.5,
    "kkdf_orani": 15.0,
    "bsmv_orani": 15.0,
    "aylik_taksit": 10998.01,
    "toplam_faiz": 24597.0,
    "toplam_kkdf": 3689.55,
    "toplam_bsmv": 3689.55,
    "toplam_geri_odeme": 131976.1,
    "yillik_maliyet_orani": 70.56,
    "odeme_plani": [
      {
        "ay": 1,
        "taksit": 10998.01,
        "anapara": 6448.01,
        "faiz": 3500.0,
        "kkdf": 525.0,
        "bsmv": 525.0,
        "kalan": 93551.99
      },
      {
        "ay": 2,
        "taksit": 10998.01,
        "anapara": 6741.39,
        "faiz": 3274.32,
        "kkdf": 491.15,
        "bsmv": 491.15,
        "kalan": 86810.6
      },
      {
        "ay": 3,
        "taksit": 10998.01,
        "anapara": 7048.13,
        "faiz": 3038.37,
        "kkdf": 455.76,
        "bsmv": 455.76,
        "kalan": 79762.47
      },
      "… 9 öğe daha"
    ],
    "not": "Dosya masrafı, sigorta ve ekspertiz ücretleri dahil değildir; bankanın teklifindeki tutar farklı olabilir.",
    "kaynak_belge": "KKDF: 88/12944 sayılı BKK ve değişiklikleri; BSMV: 6802 sayılı Kanun m.28, Cumhurbaşkanı kararları"
  },
  "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/hesapla/kredi ücretli paket 1 birim

Kredi ödeme planı: taksit, faiz, KKDF, BSMV

ParametreTürAçıklama
tutar* sayı
vade* tam sayı Ay
faiz* sayı Aylık akdi faiz (%), vergiler hariç
tur metin varsayılan: ihtiyac
kkdf sayı
bsmv sayı
plan evet/hayır Ödeme planı tablosu dahil varsayılan: True
GET /v1/hesapla/mevduat ücretli paket 1 birim

Mevduat getirisi: brüt, stopaj, net

ParametreTürAçıklama
tutar* sayı
faiz* sayı Yıllık brüt faiz (%)
gun tam sayı Vade (gün) varsayılan: 32
para metin varsayılan: tl
stopaj sayı
GET /v1/hesapla/mtv ücretli paket 1 birim

Motorlu Taşıtlar Vergisi (otomobil, elektrikli, motosiklet, panelvan)

ParametreTürAçıklama
silindir tam sayı Motor silindir hacmi (cm³)
yas* tam sayı Taşıt yaşı (model yılı dahil, ör. 2026 model = 1)
deger sayı Taşıt değeri (KDV hariç; 2018 sonrası tescil)
tescil metin varsayılan: 2018_sonrasi
tur metin varsayılan: otomobil
guc sayı Elektrik motor gücü (kW)
yil tam sayı
GET /v1/hesapla/kidem ücretli paket 1 birim

Kıdem tazminatı (tavan, damga, net)

ParametreTürAçıklama
brut* sayı Son aylık brüt ücret
giris* metin
cikis* metin
ek_odeme sayı Aylık düzenli ek ödemeler (yol, yemek, ikramiye/12…) varsayılan: 0
GET /v1/hesapla/ihbar ücretli paket 1 birim

İhbar tazminatı (süre, gelir vergisi, net)

ParametreTürAçıklama
brut* sayı
giris* metin
cikis* metin
ek_odeme sayı varsayılan: 0
kumulatif_matrah sayı Yıl içinde oluşmuş gelir vergisi matrahı varsayılan: 0
GET /v1/hesapla/issizlik ücretli paket 1 birim

İşsizlik ödeneği: aylık tutar ve süre

ParametreTürAçıklama
brut_ortalama* sayı Son 4 ayın brüt kazanç ortalaması
prim_gunu* tam sayı Son 3 yıldaki prim günü
yil tam sayı
GET /v1/hesapla/emekli ücretli paket 1 birim

Emekli aylığı zammı (SSK/Bağ-Kur, memur)

ParametreTürAçıklama
aylik* sayı
tur metin varsayılan: ssk_bagkur
donem metin YYYY-01 | YYYY-07
GET /v1/hesapla/yakit ücretli paket 1 birim

Yolculuk yakıt maliyeti (ilin güncel fiyatıyla)

ParametreTürAçıklama
mesafe* sayı km
tuketim* sayı L/100 km (LPG için L, elektrik için kWh)
fiyat sayı Birim fiyat (TL)
il metin Fiyat için il (ad, slug, plaka)
yakit metin varsayılan: benzin
kisi tam sayı varsayılan: 1
gidis_donus evet/hayır varsayılan: False

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?

  • ✓Finans ve emlak sitelerinde hesaplama araçları
  • ✓Haber sitelerinde "ne kadar ödeyeceğim" içerikleri
  • ✓Avukat ve İK uygulamalarında tazminat hesabı

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.)
  • GİB Motorlu Taşıtlar Vergisi tarifesi · Mevzuat (197 sayılı Kanun, I sayılı tarife) · kaynak
    Atıf: Kaynak: Gelir İdaresi Başkanlığı MTV tarifesi (yeniden değerleme ile güncellenmiş)
  • VeriApi.Pro hesaplaması · VeriApi.Pro
    Atıf: VeriApi.Pro tarafından hesaplanmıştır

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

Sık sorulan sorular

Hesaplayıcılar ücretsiz mi?

Hayır; /v1/hesapla/* uçları Başlangıç ve üstü paketlerdedir.

Oranlar güncel mi?

KKDF/BSMV, stopaj, MTV tarifesi, kıdem tavanı ve emekli zammı mevzuat değiştikçe güncellenir; yanıtta kullanılan oranlar da döner.

Bu sayfa şu aramalar için de: kredi hesaplama api · mtv hesaplama api · kıdem tazminatı hesaplama api · mevduat faizi hesaplama api