Perbandingan API Hari Libur Nasional Indonesia 2026-2027: api.co.id, GitHub, Vercel, dan API Indonesia

Kalau Anda butuh API hari libur nasional Indonesia untuk 2027, pilihannya ada empat jenis: API komersial seperti api.co.id, file JSON di GitHub (misalnya guangrei/APIHariLibur_V2), proyek gratis yang di-hosting di Vercel/Netlify/Cloudflare (kresnasatya/api-harilibur), dan API Indonesia. Bedanya ada di sumber data, apakah cuti bersama ikut dimuat, dan apakah endpoint-nya masih hidup. Kami mengecek semuanya langsung pada 29 Oktober 2026.

Ringkasnya: untuk 2027, data resmi berasal dari SKB 3 Menteri yang menetapkan 18 hari libur nasional dan 8 hari cuti bersama. API Indonesia memuat ke-26 baris itu lengkap dengan penanda cuti bersama dan kolom source. Endpoint Vercel yang sering dipakai tutorial lama sedang tidak aktif (HTTP 402).

Ringkasan perbandingan

	api.co.id	guangrei/APIHariLibur_V2	kresnasatya/api-harilibur	API Indonesia
Jenis	REST API, wajib API key	File JSON statis di GitHub	API gratis di 3 hosting	REST API, wajib API key
Biaya	Gratis, 0 poin per hit	Gratis	Gratis	Bonus 3.000 kredit, lalu 2 kredit (Rp2) per request sukses
Sumber data (menurut halaman masing-masing)	"Tersinkron dengan rilis resmi"	Google Calendar	kalenderbali.com	SKB 3 Menteri 2027 (kolom source)
Cuti bersama 2027	Ada flag is_joint_holiday	Sebagian (7 entri cuti bersama di data 2027)	Tidak ada	Ada, 8 baris dengan is_joint_leave: 1
Status 29 Okt 2026	Aktif	Aktif	Vercel: HTTP 402, Netlify: array kosong, Cloudflare Pages: aktif	Aktif
Data lain dengan key yang sama	Ya (katalog berbayar)	Tidak	Tidak	30 produk API

1. api.co.id

Halaman Indonesia Holiday Calendar API menyebut API ini 100% gratis dengan 0 poin per hit, tetapi tetap perlu daftar untuk mendapat API key. Ada tiga endpoint: daftar libur per tahun, cek satu tanggal, dan libur terdekat. Respons memuat is_joint_holiday dan is_observance, jadi hari peringatan non-libur juga ikut.

Cocok untuk: tim yang sudah memakai produk api.co.id lain. Catatan: halamannya tidak menyebut nomor SKB yang dipakai, jadi verifikasi sendiri tanggal Idulfitri dan Iduladha setelah keputusan isbat.

2. guangrei/APIHariLibur_V2 (GitHub)

Repo guangrei/APIHariLibur_V2 menyediakan holidays.json dan calendar.json yang diperbarui otomatis. README-nya menyebut data bersumber dari Google Calendar. Untuk 2027 file holidays.json berisi 24 tanggal dengan label seperti "Hari Idul Fitri (belum pasti)". Tujuh di antaranya cuti bersama, tetapi 18 Mei (cuti bersama Iduladha di SKB) diberi label "Idul Adha (Lebaran Haji)" dan Paskah 28 Maret tidak ada.

Cocok untuk: proyek yang cukup memuat satu file JSON saat build. Catatan: formatnya objek dengan kunci tanggal dan satu field summary. Tidak ada penanda libur nasional vs cuti bersama selain dari teks, dan sebagian label campur bahasa Inggris (misalnya "Joint Holiday for Good Friday").

3. kresnasatya/api-harilibur (Vercel, Netlify, Cloudflare)

Ini yang sering muncul saat orang mencari "api hari libur vercel". README proyeknya menyebut tiga domain dan sumber data kalenderbali.com. Hasil cek kami pada 29 Oktober 2026:

• api-harilibur.vercel.app mengembalikan HTTP 402, DEPLOYMENT_DISABLED.
• api-harilibur.netlify.app/api?year=2027 mengembalikan array kosong.
• api-harilibur.pages.dev/api?year=2027 masih aktif: 28 entri, 17 di antaranya libur nasional, ditambah hari raya Bali. Tidak ada cuti bersama, Isra Mikraj 1449 H tercatat 25 Desember (SKB: 26 Desember), dan tanggal ditulis tanpa nol di depan (2027-01-1).

Kalau integrasi Anda tiba-tiba kosong atau error, kemungkinan besar penyebabnya ini.

4. API Indonesia

Data 2027 di API Indonesia mengikuti SKB Menteri Agama, Menteri Ketenagakerjaan, dan Menteri PANRB No. 1205/2026, No. 3/2026, No. 2/2026 yang ditandatangani 15 September 2026 (siaran pers KemenPANRB). Isinya 26 baris: 18 libur nasional dan 8 cuti bersama, masing-masing dengan type, is_joint_leave, dan source. Daftar lengkapnya bisa dilihat di halaman Kalender Libur Nasional 2027.

Data 2026 di API juga mengikuti SKB 3 Menteri: 17 hari libur nasional dan 8 hari cuti bersama, total 25 baris aktif dengan sumber skb-3-menteri-2026. Data diperbarui pada 29 Oktober 2026 berdasarkan SKB No. 1497/2025, No. 2/2025, dan No. 5/2025.

Contoh: semua libur 2027

curl "https://use.apiindonesia.id/api/v1/libur?tahun=2027" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "4bc1e88f-b3cf-5058-a98f-429c5769707d",
      "date": "2027-03-09",
      "name": "Cuti Bersama Idulfitri 1448 H",
      "type": "cuti_bersama",
      "is_joint_leave": 1,
      "source": "skb-3-menteri-2027",
      "year": 2027,
      "is_active": 1
    }
  ]
}

Contoh: cek apakah tanggal tertentu hari libur (JavaScript)

async function isLibur(tanggal) {
  const [tahun, bulan] = tanggal.split('-');
  const r = await fetch(
    `https://use.apiindonesia.id/api/v1/libur?tahun=${tahun}&bulan=${bulan}`,
    { headers: { 'x-api-key': process.env.API_INDONESIA_KEY } }
  );
  const { data } = await r.json();
  return data.find((h) => h.date === tanggal) ?? null;
}

console.log(await isLibur('2027-03-12')); // Cuti Bersama Idulfitri 1448 H

Endpoint lain: GET /api/v1/libur/upcoming untuk 10 libur terdekat. Detailnya ada di halaman produk API Hari Libur dan dokumentasi.

Mana yang dipilih?

• Gratis tanpa daftar dan cukup file statis: guangrei/APIHariLibur_V2, dengan risiko label teks bebas.
• Gratis dengan API key dan sudah memakai ekosistemnya: api.co.id.
• Butuh data SKB lengkap dengan cuti bersama, sumber per baris, dan data publik lain (wilayah, UMP, jadwal sholat) dalam satu key: API Indonesia.
• Masih memakai api-harilibur.vercel.app: pindahkan sekarang, endpoint itu sedang tidak melayani request.

FAQ

Berapa hari libur nasional dan cuti bersama 2027? 18 hari libur nasional dan 8 hari cuti bersama, menurut SKB 3 Menteri yang ditandatangani 15 September 2026.

Kenapa API hari libur vercel tidak bisa diakses? Saat kami cek pada 29 Oktober 2026, api-harilibur.vercel.app mengembalikan HTTP 402 (DEPLOYMENT_DISABLED). Mirror Cloudflare Pages masih aktif, tapi tidak memuat cuti bersama.

Apakah cuti bersama termasuk hari libur di API Indonesia? Ya, cuti bersama ikut dikembalikan dengan type: "cuti_bersama" dan is_joint_leave: 1, jadi Anda bisa memilih mau menghitungnya sebagai hari libur atau tidak.

Apakah tanggal Idulfitri dan Iduladha 2027 bisa berubah? Bisa. SKB menyebut tanggal hari besar Islam mengikuti keputusan Menteri Agama setelah sidang isbat. Kalau ada perubahan, data API diperbarui.

Berapa biaya API Indonesia untuk data hari libur? Akun baru mendapat bonus 3.000 kredit sekali, setara sekitar 1.500 request. Setelah itu tiap request sukses memakai 2 kredit (Rp2). Data libur setahun cukup diambil sekali lalu di-cache.

Mulai sekarang

Daftar di dashboard.apiindonesia.id/register, ambil API key, dan dapatkan bonus 3.000 kredit tanpa kartu kredit. Panduan HR dan payroll ada di artikel API Kalender Indonesia untuk HR dan payroll.