POST AI agent ready /v1/holidays/list

API Hari Libur Nasional - Daftar Hari Libur berdasarkan Negara & Tahun

Mengembalikan semua hari libur nasional untuk negara dan tahun tertentu. Setiap hari libur mencantumkan tanggal, nama Inggris, nama lokal, dan jenisnya (Publik, Bank, Nasional, dll.). Mendukung 100+ negara dengan kode negara ISO 3166-1 alpha-2.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/holidays/list \
  -H "Content-Type: application/json" \
  -d '{"country":"US","year":2026}'

When to use this API

Estimasi tanggal pengiriman

Saat menghitung perkiraan tanggal pengiriman untuk pesanan e-niaga, kecualikan hari libur nasional dari hitungan hari kerja. Ambil daftar liburan untuk negara tujuan dan lewati tanggal tersebut dalam aritmatika tanggal Anda.

Penjadwalan karyawan dan penggajian

Secara otomatis menandai hari libur nasional di sistem penjadwalan Anda. Menghitung tarif pembayaran hari libur, mencegah manajer menjadwalkan shift yang tumpang tindih dengan hari libur resmi, dan menghasilkan laporan penggajian yang akurat.

Integrasi kalender

Isi terlebih dahulu aplikasi kalender dengan hari libur nasional untuk negara pengguna. Tampilkan hari libur bersama acara pribadi dan rapat kerja sehingga pengguna dapat merencanakan hari libur tanpa menambahkan setiap hari libur secara manual.

Frequently asked questions

Berapa banyak negara yang didukung?

Lebih dari 100 negara didukung menggunakan kode ISO 3166-1 alpha-2. Negara-negara besar seperti AS, GB, DE, FR, JP, BR, IN, AU, dan CA semuanya memiliki cakupan liburan penuh.

Apakah termasuk hari libur regional atau negara bagian?

Responsnya terfokus pada hari libur nasional. Hari libur regional atau khusus negara bagian (seperti hari libur negara bagian AS) tidak disertakan dalam daftar default.

Apa isi array tipe?

Array tipe mengklasifikasikan setiap hari libur. Nilai-nilai umum mencakup "Umum" (hari libur yang diakui pemerintah), "Bank" (hari libur bank), "Nasional" (peringatan nasional), dan "Opsional" (opsional atau hanya peringatan). Liburan bisa memiliki banyak jenis.

Bisakah saya menanyakan hari libur selama beberapa tahun terakhir?

Ya. Anda dapat menanyakan hari libur untuk tahun apa pun mulai tahun 2000 hingga 2100. Data historis berguna untuk mengaudit perhitungan penggajian sebelumnya atau memverifikasi jumlah hari kerja pada periode sebelumnya.

Apa yang terjadi jika saya menghilangkan parameter tahun?

Titik akhir defaultnya adalah tahun kalender saat ini. Jika Anda memerlukan liburan untuk tahun depan (misalnya untuk perencanaan), sampaikan tahun tersebut secara eksplisit.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.