Hesaplama API'leri
Kredi, mevduat, MTV, tazminat ve emeklilik hesaplarını kendi formülünüzü yazmadan, güncel oranlarla yapın.
/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
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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