Coverage
3
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
Calendar of national public holidays, religious holidays, and joint leave days based on the SKB 3 Menteri (joint ministerial decree).
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 tested on the free tier, 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: aip_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"{
"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
}
]
}Start free. Upgrade to Pro or Business, or buy pay as you go credits when you need a one-time top-up. Payments are processed through Sumopod.
Yearly saves 2 months
Do you want to skip subscriptions? Top up credits once from the dashboard and use them until they run out.
Open dashboardFor trying the API and early integration.
For projects that are starting to get real usage.
For production apps with higher traffic.
For high volume, SLA, or company contracts.
Quick answers to common questions about getting started, the free tier, API key security, data sources, and Sumopod billing.
