Resmî Tatiller ve Takvim API

Resmî tatiller, dini günler, hicri takvim, ay evreleri ve okul tatilleri tek takvim API'sinde.

Ücretsiz pakette var JSON · Türkçe7 uç Kaynak: Resmî Gazete / mevzuat, Diyanet dini günler takvimi, Millî Eğitim Bakanlığı çalışma takvimi, VeriApi.Pro hesaplaması (ay evreleri)

/v1/takvim/tatiller bir yılın resmî tatillerini, dini bayramları ve yarım günleri (arife, 28 Ekim) verir. /v1/takvim/gun ise tek bir tarihin hafta numarasını, iş günü olup olmadığını ve varsa tatil adını döndürür; vardiya, kargo teslim tahmini ve randevu sistemleri için idealdir.

Kandiller, Ramazan başlangıcı, hicri yılbaşı ve Aşure /v1/takvim/dini-gunler'de; /v1/takvim/hicri ve /v1/takvim/miladi iki takvim arasında dönüşüm yapar (Diyanet'in duyurduğu ay başlarıyla). Ay evresi ve dolunay saatleri /v1/takvim/ay, MEB ara tatilleri ve yarıyıl /v1/takvim/okul ucundadı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/takvim/gun?tarih=2026-10-29');
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/takvim/gun?tarih=2026-10-29", {
  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/takvim/gun?tarih=2026-10-29",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/takvim/gun?tarih=2026-10-29"

Örnek yanıt

GET https://api.veriapi.pro/v1/takvim/gun?tarih=2026-10-29 — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "tarih": "2026-10-29",
    "gun": "Perşembe",
    "ay": "Ekim",
    "yilin_gunu": 302,
    "hafta": 44,
    "hafta_yili": 2026,
    "hafta_sonu": false,
    "tatil": [
      {
        "ad": "Cumhuriyet Bayramı",
        "tur": "resmi",
        "yarim_gun": false
      }
    ],
    "is_gunu": false,
    "dini_bayram_bilgisi_var": true,
    "hicri": {
      "metin": "18 Cemaziyelevvel 1448",
      "yil": 1448,
      "ay": 5,
      "gun": 18,
      "kaynak": "hesap"
    }
  },
  "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/"
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

GET /v1/takvim/tatiller ücretsiz pakette 1 birim

Resmî tatiller ve dini bayramlar

ParametreTürAçıklama
yil tam sayı Yıl, varsayılan bu yıl
GET /v1/takvim/gun ücretsiz pakette 1 birim

Gün bilgisi: hafta numarası, iş günü, tatil

ParametreTürAçıklama
tarih metin
GET /v1/takvim/dini-gunler ücretsiz pakette 1 birim

Kandiller, Ramazan başlangıcı, hicri yılbaşı, bayramlar

ParametreTürAçıklama
yil tam sayı
GET /v1/takvim/hicri ücretsiz pakette 1 birim

Miladi tarihin hicri karşılığı (Diyanet takvimi)

ParametreTürAçıklama
tarih metin Miladi tarih (YYYY-AA-GG), varsayılan bugün
GET /v1/takvim/miladi ücretsiz pakette 1 birim

Hicri tarihin miladi karşılığı

ParametreTürAçıklama
yil* tam sayı Hicri yıl (ör. 1448)
ay* tam sayı Hicri ay (1 Muharrem … 12 Zilhicce)
gun tam sayı varsayılan: 1
GET /v1/takvim/ay ücretsiz pakette 1 birim

Ay evresi, aydınlanma yüzdesi, sıradaki dolunay / yeni ay

ParametreTürAçıklama
tarih metin YYYY-AA-GG, varsayılan bugün
GET /v1/takvim/okul ücretsiz pakette 1 birim

MEB okul takvimi: ara tatiller, yarıyıl, karne günleri

ParametreTürAçıklama
yil metin Eğitim yılı (ör. 2026-2027)

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?

  • ✓İK ve bordro yazılımında iş günü hesabı
  • ✓Randevu ve kargo teslim tarihi
  • ✓Haber sitesinde "bugün" kutusu
  • ✓Okul ve veli uygulamalarında tatil sayacı

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.)
  • Diyanet dini günler takvimi · Tarihler olgudur · kaynak
    Atıf: Kaynak: Diyanet İşleri Başkanlığı dini günler takvimine dayanan duyurular
  • Millî Eğitim Bakanlığı çalışma takvimi · Kamu duyurusu (tarihler olgudur) · kaynak
    Atıf: Kaynak: MEB eğitim-öğretim yılı çalışma takvimi genelgesi
  • VeriApi.Pro hesaplaması (ay evreleri) · VeriApi.Pro
    Atıf: Ay evreleri astronomik hesapla bulunmuştur (Meeus; ±1 dk)

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

Sık sorulan sorular

Dini bayram tarihleri nereden?

Diyanet'in duyurduğu tarihlerden; henüz duyurulmamış yıllar için bayram eklenmez, hicri dönüşüm uçları ise hesapla çalışmaya devam eder.

Yarım gün tatiller var mı?

Evet; arife günleri ve 28 Ekim yarım gün olarak işaretlenir.

Ücretsiz mi?

Takvim uçlarının tamamı ücretsiz pakette açıktır.

Bu sayfa şu aramalar için de: bayram tarihleri api · iş günü hesaplama api · hicri takvim api · okul tatili api · holiday api turkey