API Hari Libur

Karena developer juga butuh tahu kapan tanggal merah 🇮🇩

🇮🇩 Data Indonesia
Gratis & Cepat
🔓 No API Key
📱 REST API

🚀 Coba Langsung

Pilih endpoint di bawah untuk melihat response secara real-time

Loading...

Klik salah satu tombol di atas untuk melihat response...

📚 Dokumentasi API

Panduan lengkap untuk menggunakan API Hari Libur Indonesia

GET Semua Libur Tahun Ini

/api

Mendapatkan daftar semua hari libur dan cuti bersama pada tahun berjalan.

💡 Contoh Request

JavaScript
fetch('{{BASE_URL}}/api')
  .then(res => res.json())
  .then(data => console.log(data));

GET Libur Tahun Tertentu

/api?year={tahun}

Mendapatkan daftar hari libur pada tahun yang ditentukan.

📋 Parameters

year
Tahun yang ingin dicari (contoh: 2024)

💡 Contoh Request

JavaScript
const year = 2024;

fetch(`{{BASE_URL}}/api?year=${year}`)
  .then(res => res.json())
  .then(data => console.log(data));

GET Libur Bulan Tertentu

/api?month={bulan}

Mendapatkan daftar hari libur pada bulan tertentu di tahun berjalan.

📋 Parameters

month
Bulan (1-12, contoh: 8 untuk Agustus)

💡 Contoh Request

JavaScript
const month = 8; // Agustus

fetch(`{{BASE_URL}}/api?month=${month}`)
  .then(res => res.json())
  .then(data => console.log(data));

GET Libur Bulan & Tahun

/api?year={tahun}&month={bulan}

Mendapatkan daftar hari libur pada bulan dan tahun yang spesifik.

📋 Parameters

year
Tahun yang ingin dicari
month
Bulan (1-12)

💡 Contoh Request

JavaScript
const year = 2024;
const month = 8;

fetch(`{{BASE_URL}}/api?year=${year}&month=${month}`)
  .then(res => res.json())
  .then(data => console.log(data));

GET Cek Tanggal Spesifik

/api?year={tahun}&month={bulan}&day={hari}

Mengecek apakah tanggal tertentu adalah hari libur atau bukan.

📋 Parameters

year
Tahun
month
Bulan (1-12)
day
Tanggal (1-31)

💡 Contoh Request

JavaScript
const year = 2024;
const month = 8;
const day = 17;

fetch(`{{BASE_URL}}/api?year=${year}&month=${month}&day=${day}`)
  .then(res => res.json())
  .then(data => {
    if (data.is_holiday) {
      console.log('🎉 Tanggal ini libur!');
      console.log('Libur:', data.holiday_list.join(', '));
    } else {
      console.log('Bukan hari libur');
    }
  });

GET Cek Hari Ini

/api/today

Mengecek apakah hari ini adalah hari libur atau tidak.

💡 Contoh Request

JavaScript
fetch('{{BASE_URL}}/api/today')
  .then(res => res.json())
  .then(data => {
    if (data.is_holiday) {
      console.log('🎉 Hari ini libur!');
      console.log('Libur:', data.holiday_list.join(', '));
    } else {
      console.log('💼 Hari ini kerja');
    }
  });

GET Cek Besok

/api/tomorrow

Mengecek apakah besok adalah hari libur atau tidak.

💡 Contoh Request

JavaScript
fetch('{{BASE_URL}}/api/tomorrow')
  .then(res => res.json())
  .then(data => {
    if (data.is_holiday) {
      console.log('🎉 Besok libur!');
      console.log('Libur:', data.holiday_list.join(', '));
    } else {
      console.log('💼 Besok masih kerja');
    }
  });

📊 Format Response

Struktur data yang dikembalikan oleh API

Response untuk List Hari Libur

Endpoint yang mengembalikan daftar hari libur akan memberikan array of objects dengan struktur berikut:

JSON
[
  {
    "date": "2026-01-01",
    "name": "Tahun Baru 2026 Masehi"
  },
  {
    "date": "2026-01-16",
    "name": "Isra Mikraj Nabi Muhammad S.A.W."
  },
  {
    "date": "2026-08-17",
    "name": "Proklamasi Kemerdekaan"
  }
]

📋 Field Descriptions

date
Tanggal libur dalam format YYYY-MM-DD
name
Nama hari libur atau cuti bersama

Response untuk Cek Tanggal (today/tomorrow/specific date)

Endpoint /api/today, /api/tomorrow, dan query dengan parameter lengkap (year, month, day) menggunakan format yang sama:

JSON - Jika Libur
{
  "date": "2026-08-17",
  "is_holiday": true,
  "holiday_list": ["Proklamasi Kemerdekaan"]
}
JSON - Jika Bukan Libur
{
  "date": "2026-01-13",
  "is_holiday": false,
  "holiday_list": []
}

📋 Field Descriptions

date
Tanggal yang dicek dalam format YYYY-MM-DD
is_holiday
Boolean - true jika tanggal tersebut adalah hari libur/cuti
holiday_list
Array of string - Daftar nama hari libur (kosong jika bukan libur)

✨ Kenapa Pakai API Ini?

🚀

Mudah Digunakan

Tidak perlu API key, tidak perlu registrasi. Langsung pakai dan integrasikan ke aplikasi Anda.

📅

Data Akurat

Data hari libur dan cuti bersama resmi dari pemerintah Indonesia, selalu up-to-date.

Performa Cepat

Response time cepat dengan infrastruktur Deno Deploy yang reliable dan scalable.

💡 Use Cases

Ide penggunaan API ini dalam aplikasi Anda

🗓️ Aplikasi Kalender

Tandai hari libur nasional dan cuti bersama secara otomatis di aplikasi kalender Anda.

💼 HR Management System

Integrasikan dengan sistem absensi untuk menghitung hari kerja efektif dan cuti karyawan.

📱 Reminder App

Kirim notifikasi sebelum hari libur untuk membantu planning aktivitas pengguna.

🏢 Scheduling System

Hindari penjadwalan meeting atau event pada hari libur nasional.

📊 Business Intelligence

Analisis performa bisnis dengan memperhitungkan hari libur dalam laporan.

🎯 Project Management

Hitung deadline dan estimasi proyek dengan akurat berdasarkan hari kerja.