Resmî Tatiller ve Takvim API
Resmî tatiller, dini günler, hicri takvim, ay evreleri ve okul tatilleri tek takvim API'sinde.
/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
| Parametre | Tür | Açı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
| Parametre | Tür | Açıklama |
|---|---|---|
| tarih | metin |
GET /v1/takvim/dini-gunler
ücretsiz pakette
1 birim
Kandiller, Ramazan başlangıcı, hicri yılbaşı, bayramlar
| Parametre | Tür | Açıklama |
|---|---|---|
| yil | tam sayı |
GET /v1/takvim/hicri
ücretsiz pakette
1 birim
Miladi tarihin hicri karşılığı (Diyanet takvimi)
| Parametre | Tür | Açı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ığı
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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