Bordro API

Siteyi çalıştıran bordro motoruna doğrudan erişim. Anahtar gerekmez, kayıt gerekmez, ücretsizdir. Brüt veya net ücret verirsiniz; 12 ayın tamamı için kesinti dökümü, net ücret, vergi dilimi geçişleri ve işveren maliyeti JSON olarak döner. Sayfalarda gördüğünüz sonuçlarla API çıktısı aynı motordan gelir, dolayısıyla birbirinden sapamaz.

Mevzuat verisi son güncelleme: 28 Ocak 2026 · Kapsanan yıllar 2006-2026 · Para birimi TRY

Uç Nokta

GET https://maashesaplayici.com/api/hesapla

CORS açıktır (Access-Control-Allow-Origin: *), yani tarayıcıdan da çağrılabilir. Yanıtlar bir saat önbelleklenebilir.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
brut	sayı	Koşullu	Aylık brüt ücret. `net` ile birlikte kullanılamaz. Alt sınır o yılın brüt asgari ücretidir.
net	sayı	Koşullu	Hedeflenen aylık net ücret. `brut` ile birlikte kullanılamaz. Alt sınır o yılın net asgari ücretidir.
yil	tam sayı	Hayır	Hesaplama yılı. Varsayılan 2026. Kapsanan aralık 2006-2026.

brut ve net parametrelerinden tam olarak biri verilmelidir; ikisi birlikte gönderilirse hesaplama yönü belirsiz kalacağı için istek reddedilir. Sayılarda Türkçe biçim de kabul edilir: 50.000 ve 50000 aynı sonucu verir.

Örnek İstek

curl "https://maashesaplayici.com/api/hesapla?brut=50000&yil=2026"

Yanıt (kısaltılmış)

{
  "kaynak": "https://maashesaplayici.com",
  "surum": "1.0",
  "veriRevizyonu": "2026-01-28",
  "girdi": {
    "yon": "brutten-nete",
    "tutar": 50000,
    "yil": 2026
  },
  "parametreler": {
    "brutAsgariUcret": 33030,
    "sgkTavani": 297270,
    "vergiDilimleri": [
      {
        "ustSinir": 190000,
        "oran": 0.15
      },
      {
        "ustSinir": 400000,
        "oran": 0.2
      },
      {
        "ustSinir": 1500000,
        "oran": 0.27
      },
      {
        "ustSinir": 5300000,
        "oran": 0.35
      },
      {
        "ustSinir": null,
        "oran": 0.4
      }
    ]
  },
  "ozet": {
    "ocakNet": 40207.53,
    "aralikNet": 36511.3,
    "yillikToplamNet": 466135.62,
    "yillikIsverenMaliyeti": 742500,
    "netDusus": 3696.23
  },
  "aylar": [
    {
      "ayNo": 1,
      "ay": "Ocak",
      "brut": 50000,
      "sgkPrimi": 7000,
      "issizlikPrimi": 500,
      "gelirVergisi": 2163.67,
      "damgaVergisi": 128.8,
      "net": 40207.53,
      "vergiDilimiOrani": 0.15,
      "isverenMaliyeti": 61875
    },
    "… 12 ayın tamamı döner …"
  ],
  "toplam": {
    "gross": 600000,
    "net": 466135.62,
    "sgkEmployee": 84000,
    "unemploymentEmployee": 6000,
    "incomeTax": 42318.78,
    "stampTax": 1545.6,
    "totalDeduction": 133864.38,
    "employerCost": 742500
  }
}

Tam yanıt ayrıca varsayimlar, dilimDegisimleri, dayanak (kanun maddeleri), lisans ve yasalUyari alanlarını içerir. ozet.aciklama alanı ise sonucu tek cümlede özetler.

Hatalar

Geçersiz istekler 400 ile döner ve hata alanında Türkçe bir açıklama taşır. Başlıca durumlar:

brut ve net parametrelerinin ikisi de verilmemiş ya da ikisi birden verilmiş
Desteklenmeyen yıl (2006-2026 aralığı dışında)
Tutar o yılın asgari ücretinin altında — mevzuat gereği geçerli bir bordro üretmez

Varsayımlar ve Sınırlar

API standart bir çalışan profili için hesaplar: bekâr, çocuksuz, 4A (SSK) statüsünde, ay 30 gün, asgari ücret istisnası uygulanıyor, işveren teşviki yok. Engellilik indirimi, BES, sendika aidatı, yemek ve yol yardımı, prim ve ikramiye gibi kalemler yanıtta yer almaz; bunlar için sitedeki hesaplayıcıyı kullanın. Hesaplama adımlarının tamamı ve bilinen sınırlar metodoloji sayfasında yazılıdır.

Kullanım Koşulları

API ücretsizdir ve sonuçlar serbestçe kullanılabilir. Kaynak olarak maashesaplayici.com belirtilmesi rica olunur. Kota uygulanmıyor; makul kullanım bekleniyor. Toplu veri ihtiyacı için tek istekte tüm seriyi veren llms-full.txt dosyasını kullanmak daha verimlidir. Ayrıntılı koşullar kullanım şartları sayfasındadır.