API Reference
Islamic Calendar
Generate a Hijri month grid (with events) or a full 12-month year overview.
GET /api/v1/calendar/islamic- Pass
hmfor a single month grid. - Omit
hmfor a year overview (12 months + events).
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
hy | int | current | Hijri year 1…3000 |
hm | int | — | Hijri month 1…12 (month grid) |
method | string | tabular | Hijri method |
locale | string | id | Label language |
GET
/calendar/islamicLiveGET /calendar/islamic?hy=1447&hm=9&method=umm_al_qura&locale=idMonth grid
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"
}
]
}
]
}
}Each entry in days[].events is a full Event object.
Year overview
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" } ]
}
}