Referensi API
Kalender Islam
Hasilkan grid bulan Hijriah (beserta acara) atau ikhtisar satu tahun penuh berisi 12 bulan.
GET /api/v1/calendar/islamic- Gunakan
hmuntuk grid satu bulan. - Hilangkan
hmuntuk ikhtisar satu tahun (12 bulan + acara).
Parameter kueri
| Param | Type | Default | Deskripsi |
|---|---|---|---|
hy | int | saat ini | Tahun Hijriah 1…3000 |
hm | int | — | Bulan Hijriah 1…12 (grid bulan) |
method | string | tabular | Metode Hijriah |
locale | string | id | Bahasa label |
GET
/calendar/islamicLangsungGET /calendar/islamic?hy=1447&hm=9&method=umm_al_qura&locale=idGrid bulan
curl "https://api.housemuslim.org/api/v1/calendar/islamic?hy=1447&hm=9&locale=id"const res = await fetch('https://api.housemuslim.org/api/v1/calendar/islamic?hy=1447&hm=9&locale=id');
const { data } = await res.json();
console.log(data.month_name, data.length); // Ramadhan 30{
"success": true,
"data": {
"hijri_year": 1447,
"hijri_month": 9,
"month_name": "Ramadhan",
"length": 30,
"days": [
{
"gregorian": "2026-02-18",
"hijri": { "year": 1447, "month": 9, "day": 1 },
"hijri_label": "1 Ramadhan 1447 H",
"weekday": "Rabu",
"events": [
{
"key": "ramadan_start",
"name": "Awal Ramadhan",
"desc": "Hari pertama puasa Ramadhan.",
"hijri": { "year": 1447, "month": 9, "day": 1 },
"gregorian": "2026-02-18",
"weekday": "Rabu"
}
]
}
]
}
}Setiap entri dalam days[].events adalah objek Event yang lengkap.
Ikhtisar tahun
curl "https://api.housemuslim.org/api/v1/calendar/islamic?hy=1447"const res = await fetch('https://api.housemuslim.org/api/v1/calendar/islamic?hy=1447');
const { data } = await res.json();
console.log(data.months.length); // 12{
"success": true,
"data": {
"hijri_year": 1447,
"months": [
{ "month": 1, "name": "Muharram", "length": 30, "gregorian_start": "2025-06-26" }
],
"events": [ { "key": "ashura", "name": "Hari Asyura", "gregorian": "2025-07-05" } ]
}
}