Coverage
3
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
The Public Holiday API lists national holidays, religious holidays and joint leave days (cuti bersama) based on the SKB 3 Menteri decree. For 2027 it has 18 public holidays and 8 joint leave days; filter by year or month, or fetch the next 10 upcoming holidays.
Calendar of national public holidays, religious holidays, and joint leave days based on the SKB 3 Menteri (joint ministerial decree).
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.
https://use.apiindonesia.id/api/v1/liburReturns a list of public holidays, sorted by date. Can be filtered by year and month.
The Public Holidays API is useful for apps that calculate working days, operating schedules, deadlines, SLAs, or leave calendars without manually updating holidays every year.
Due-date calculations must skip national holidays and joint leave days.
Operations teams need the same calendar across dashboards, reminders, and notifications.
HR, payroll, booking, or logistics products need to know whether a date is a working day.
For company-specific rules such as regional substitute days or shift schedules, add your own policy layer in the app.
This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.
curl "https://use.apiindonesia.id/api/v1/libur?tahun=2026" \
-H "x-api-key: YOUR_API_KEY"{
"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
}
]
}Idulfitri 1448 H menurut SKB 3 Menteri jatuh 10-11 Maret 2027, cuti bersama 9, 12, dan 15 Maret. Versi Muhammadiyah, status penetapan pemerintah dan NU, plus data via API.
Daftar long weekend 2027 dari SKB 3 Menteri, hari kejepit, tabel hari kerja efektif per bulan (250 atau 242 hari), dan kode JavaScript untuk menghitungnya.
Perbandingan jujur API hari libur nasional Indonesia untuk 2027: sumber data, cuti bersama, status endpoint, dan biaya. Dicek langsung 29 Oktober 2026.
Each record has a type field (nasional, keagamaan or cuti_bersama) and is_joint_leave set to 1 for joint leave days, so you can separate official holidays from cuti bersama.
Call GET /api/v1/libur?tahun=2027 and add bulan=03 (two digits) for a single month. Results are sorted by date.
GET /api/v1/libur/upcoming returns up to 10 upcoming holidays counted from today, which suits calendar widgets and reminders.
Free JSON files for 2026 and 2027 are at apiindonesia.id/data/libur-nasional-2026.json and apiindonesia.id/data/libur-nasional-2027.json, generated from the same data as the API.
