Referensi API

Hari Libur

API Hari Libur berisi daftar libur nasional, libur keagamaan, dan cuti bersama sesuai SKB 3 Menteri. Untuk 2027 tersedia 18 hari libur nasional dan 8 hari cuti bersama; filter per tahun atau bulan, atau ambil 10 hari libur terdekat dari hari ini.

Endpoint utama
GET https://use.apiindonesia.id/api/v1/libur
Jumlah endpoint
3
Autentikasi
Header x-api-key (buat gratis di dashboard)
Harga
2 kredit (Rp2) per request sukses; request gagal gratis
Format
JSON (REST), contoh cURL, JavaScript, Python
Ringkasan Produk

Apa yang Anda dapat dari API ini

Kalender hari libur nasional, hari besar keagamaan, dan cuti bersama berdasarkan SKB 3 Menteri.

Cakupan
3

endpoint siap pakai dalam produk ini, dengan respons JSON dan pola error yang konsisten.

Akses
API key

Bisa dicoba dengan bonus 3.000 kredit saat daftar, lalu dipakai di production lewat satu API key API Indonesia.

Contoh resource
https://use.apiindonesia.id/api/v1/libur

Mengembalikan daftar hari libur, diurutkan berdasarkan tanggal. Bisa difilter per tahun dan bulan.

Kapan API ini layak dipakai?

API Hari Libur berguna untuk aplikasi yang perlu menghitung hari kerja, jadwal operasional, deadline, SLA, atau kalender cuti tanpa memperbarui daftar libur secara manual tiap tahun.

Perhitungan tanggal jatuh tempo harus melewati libur nasional dan cuti bersama.

Tim operasional butuh kalender yang sama di dashboard, reminder, dan notifikasi.

Produk HR, payroll, booking, atau logistik perlu tahu apakah sebuah tanggal termasuk hari kerja.

Untuk aturan kantor seperti pengganti libur regional atau jadwal shift, tambahkan layer aturan internal di aplikasi Anda.

Contoh skenario produk

Bagian ini membedakan halaman produk dari dokumentasi. Dokumentasi menjawab cara memanggil endpoint; halaman ini menjawab kenapa endpoint tersebut masuk akal untuk fitur Anda.

  • HR-tech: hitung otomatis jatah cuti karyawan dan hari kerja efektif tiap bulan.
  • Logistik: jadwalkan pengiriman/operasional dengan mempertimbangkan hari libur dan cuti bersama.
  • Aplikasi kalender & produktivitas: tampilkan hari libur nasional tanpa update manual tiap tahun.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/libur?tahun=2026" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "data": [
    {
      "id": "hol_2026_001",
      "date": "2026-01-01",
      "name": "Tahun Baru 2026 Masehi",
      "type": "nasional",
      "is_joint_leave": 0,
      "description": null,
      "source": "SKB 3 Menteri",
      "year": 2026,
      "is_active": 1
    }
  ]
}

Artikel Terkait

Harga 2 kredit (Rp2) per request sukses; request gagal gratis. Bonus 3.000 kredit sekali saat daftar, tanpa kartu kredit dan tanpa jatah bulanan.

Pertanyaan seputar API Hari Libur

Apa bedanya libur nasional, keagamaan, dan cuti bersama di respons?

Setiap data punya field type (nasional, keagamaan, atau cuti_bersama) dan is_joint_leave bernilai 1 untuk cuti bersama, sehingga Anda bisa memisahkan hari libur resmi dari cuti bersama.

Bagaimana mengambil hari libur satu tahun atau satu bulan?

Gunakan GET /api/v1/libur?tahun=2027, dan tambahkan bulan=03 (dua digit) untuk satu bulan. Hasilnya diurutkan berdasarkan tanggal.

Bagaimana menampilkan hari libur terdekat?

GET /api/v1/libur/upcoming mengembalikan sampai 10 hari libur berikutnya dihitung dari hari ini, cocok untuk widget kalender atau pengingat.

Apakah ada data libur dalam format file?

Ada file JSON gratis untuk 2026 dan 2027 di apiindonesia.id/data/libur-nasional-2026.json dan apiindonesia.id/data/libur-nasional-2027.json, dibuat dari data yang sama dengan API.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik