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 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
}
]
}Start with a one-time 3,000 credit bonus at signup (Rp3,000, granted after email verification), with no monthly allowance. Upgrade to Pro or Business, or buy pay as you go credits when you need a one-time top-up. One credit equals Rp1, and the price is per product per hit: a successful public data request costs 2 credits. A failed hit is free. 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. One credit equals Rp1: a successful public data request costs 2 credits (Rp2), and a failed request is never charged.
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 signup bonus, API key security, data sources, and Sumopod billing.