API v1

API Documentation

API untuk mengambil data kalender, hari libur nasional, dan cuti bersama Indonesia secara mudah dan terstruktur.

GET
4
API Endpoints
JSON
REST
Response Format
ID
Indonesia
Calendar Region

Available Endpoints

4 endpoints tersedia
GET /api

Mengambil seluruh data hari libur nasional dan cuti bersama yang tersedia.

Request 
GET /api
Response 
{
  "tanggal": "2026-01-01",
  "tanggal_display": "Kamis, 1 Januari 2026",
  "keterangan": "Tahun Baru Masehi 2026",
  "type": "libur_nasional"
}
GET /api?year=2026

Mengambil data hari libur berdasarkan tahun tertentu.

Query Parameters
year integer Tahun kalender yang ingin diambil. Contoh: 2026.
Request 
GET /api?year=2026
Response 
[
  {
    "tanggal": "2026-01-01",
    "tanggal_display": "Kamis, 1 Januari 2026",
    "keterangan": "Tahun Baru Masehi 2026",
    "type": "libur_nasional"
  },
  {
    "tanggal": "2026-01-16",
    "tanggal_display": "Jumat, 16 Januari 2026",
    "keterangan": "Isra Mikraj Nabi Muhammad SAW",
    "type": "libur_nasional"
  }
]
GET /api?month=3

Mengambil data hari libur berdasarkan bulan tertentu.

Query Parameters
month integer Bulan kalender dengan nilai 1 sampai 12.
Request 
GET /api?month=3
Response 
[
  {
    "tanggal": "2026-03-20",
    "tanggal_display": "Jumat, 20 Maret 2026",
    "keterangan": "Cuti Bersama",
    "type": "cuti_bersama"
  }
]
GET /api?month=3&year=2026

Mengambil data hari libur berdasarkan bulan dan tahun tertentu.

Query Parameters
month integer Bulan kalender dengan nilai 1 sampai 12.
year integer Tahun kalender yang ingin diambil.
Request 
GET /api?month=3&year=2026
Response 
[
  {
    "tanggal": "2026-03-20",
    "tanggal_display": "Jumat, 20 Maret 2026",
    "keterangan": "Cuti Bersama",
    "type": "cuti_bersama"
  },
  {
    "tanggal": "2026-03-21",
    "tanggal_display": "Sabtu, 21 Maret 2026",
    "keterangan": "Hari Raya Nyepi",
    "type": "libur_nasional"
  }
]

Response Structure

Format data

Setiap data kalender memiliki struktur response yang konsisten.

Field 
tanggal
tanggal_display
keterangan
type
Example 
{
  "tanggal": "2026-01-01",
  "tanggal_display": "Kamis, 1 Januari 2026",
  "keterangan": "Tahun Baru Masehi 2026",
  "type": "libur_nasional"
}
i
Type Hari Libur
libur_nasional digunakan untuk hari libur nasional.
cuti_bersama digunakan untuk cuti bersama.
i
Informasi API
Semua endpoint menggunakan HTTP GET dan response dikembalikan dalam format JSON.

Parameter year dan month bersifat opsional.
Calendar API Documentation