Perkenalkan Informasi Hari Libur Nasional Indonesia dan Gratis Akses API

Apakah Anda merencanakan perjalanan untuk liburan atau hanya mendapatkan informasi tentang hari libur nasional mendatang? Apa pun itu, kami punya kabar baik untuk Anda! Website kami menyediakan informasi hari libur nasional Indonesia beserta akses API dan MCP gratis bagi Anda yang ingin menggunakannya di aplikasi Anda.

Halaman informasinya dapat diakses pada link berikut: Hari Libur Nasional Indonesia.

¶Tampilan Kalender 12 Bulan

Halaman hari libur ditampilkan sebagai kalender 12 bulan penuh, dari Januari hingga Desember. Setiap bulan ditampilkan dalam bentuk grid kalender:

• Abu-abu — akhir pekan (Sabtu dan Minggu).
• Merah — libur nasional.
• Kuning — cuti bersama.
• Lingkaran hijau — hari ini.

Klik tanggal yang berwarna untuk melompat ke daftar detail di bawah kalender. Untuk melihat tahun lain, ganti melalui pilihan tahun di bagian atas halaman.

¶Libur Nasional dan Cuti Bersama

Tanggal merah dibedakan menjadi dua jenis:

• Libur nasional — hari libur resmi yang ditetapkan pemerintah, misalnya Hari Kemerdekaan dan Hari Raya Natal.
• Cuti bersama — hari cuti bersama yang umumnya bersebelahan dengan hari libur nasional, misalnya cuti bersama Lebaran.

Jumlah masing-masing jenis ditampilkan pada legenda di atas kalender, dan setiap entri pada daftar detail diberi label Libur nasional atau Cuti bersama.

¶Gratis Akses API

Kami menyediakan akses API secara gratis bagi Anda yang ingin menggunakan data hari libur di aplikasi Anda. Tanpa pendaftaran dan tanpa API key.

¶Melihat daftar hari libur di Indonesia

GET /api/public-holiday

Parameter yang tersedia:

• year — filter berdasarkan tahun (contoh: ?year=2026)
• month — filter berdasarkan bulan 1–12, wajib disertai year (contoh: ?month=12&year=2026)
• status — filter berdasarkan status (confirmed, pending, cancelled), default: confirmed
• start_date & end_date — filter berdasarkan rentang tanggal (contoh: ?start_date=2026-12-01&end_date=2026-12-31)
• format — format response (human atau machine), default: human

Contoh penggunaan:

# Hari libur tahun 2026
GET /api/public-holiday?year=2026

# Hari libur bulan Desember 2026
GET /api/public-holiday?month=12&year=2026

# Hari libur dengan status pending
GET /api/public-holiday?status=pending

# Hari libur dalam rentang tanggal tertentu
GET /api/public-holiday?start_date=2026-12-01&end_date=2026-12-31

# Data dalam format machine-readable (untuk developer)
GET /api/public-holiday?year=2026&format=machine

Response format human (default):

[
  {
    "date": "Senin, 17 Agustus 2026",
    "summary": "Hari Kemerdekaan",
    "status": "confirmed"
  }
]

Response format machine:

[
  {
    "id": 1,
    "summary": "Hari Kemerdekaan",
    "start_at": "2026-08-17",
    "end_at": "2026-08-18",
    "status": "confirmed",
    "duration_days": 1,
    "created_at": "2026-01-01T00:00:00.000000Z",
    "updated_at": "2026-01-01T00:00:00.000000Z"
  }
]

¶Mengecek apakah hari ini hari libur

GET /api/public-holiday/is-now-public-holiday

Response:

{
  "is_holiday": true,
  "date": "25 Desember 2026",
  "day_name": "Jumat",
  "summary": "Natal",
  "holiday_details": {
    "id": 1,
    "summary": "Natal",
    "start_at": "2026-12-25",
    "end_at": "2026-12-25",
    "duration_days": 1
  }
}

¶Mengecek apakah tanggal tertentu adalah hari libur

GET /api/public-holiday/check/{date}

Contoh:

# Cek tanggal 25 Desember 2026
GET /api/public-holiday/check/2026-12-25

Response:

{
  "is_holiday": true,
  "date": "25 Desember 2026",
  "day_name": "Jumat",
  "summary": "Natal",
  "holiday_details": {
    "id": 1,
    "summary": "Natal",
    "start_at": "2026-12-25",
    "end_at": "2026-12-25",
    "duration_days": 1
  }
}

¶Melihat hari libur yang akan datang

GET /api/public-holiday/near

Response:

{
  "date": "Jumat, 25 Desember 2026",
  "summary": "Natal"
}

Catatan:

• Akhir pekan (Sabtu dan Minggu) ikut dihitung sebagai hari libur. Jika holiday_details bernilai null, berarti hari tersebut libur karena akhir pekan.
• Semua endpoint selalu mengembalikan status 200. Jika data kosong, hasilnya [].

¶Gratis Akses MCP untuk AI Agent

Selain REST API, data hari libur juga tersedia melalui MCP (Model Context Protocol) untuk AI agent seperti Claude Desktop, Cursor, atau VS Code Copilot. Gratis dan tanpa token.

Endpoint:

POST https://myopentrip.com/mcp/public-holidays

Tersedia 3 tools (nama tool menyertakan akhiran -tool):

• list-holidays-tool — daftar hari libur per tahun. Parameter opsional: month (1–12) dan type (nasional atau cuti_bersama).
• check-holiday-tool — mengecek satu tanggal. Parameter date format Y-m-d (default: hari ini). Menjawab is_holiday, is_weekend, summary, dan type.
• next-holiday-tool — hari libur terdekat dari hari ini. Tanpa parameter.

Setiap data libur menyertakan type (nasional atau cuti_bersama). Akhir pekan dihitung sebagai hari libur, konsisten dengan REST API di atas.

Bila ada saran dan pendapat, Anda dapat mengirimkannya ke Twitter @myopentrip.