API Reference
Islamic Events
All Islamic holidays and observances for a Gregorian or Hijri year, with both calendar dates.
GET /api/v1/events- Pass
yearfor a Gregorian year (may span two Hijri years). - Pass
hyfor a Hijri year.
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
year | int | current | Gregorian year 1900…3000 |
hy | int | — | Hijri year 1…3000 (overrides year) |
method | string | tabular | Hijri method |
locale | string | id | Label language |
GET
/eventsLiveGET /events?year=2026&method=umm_al_qura&locale=enExample
curl "https://api.housemuslim.org/api/v1/events?year=2026&locale=en"const res = await fetch('https://api.housemuslim.org/api/v1/events?year=2026&locale=en');
const { data } = await res.json();
data.forEach((e) => console.log(e.gregorian, e.name));{
"success": true,
"data": [
{
"key": "isra_miraj",
"name": "Isra and Mi'raj",
"desc": "The Prophet's ﷺ night journey and ascension.",
"hijri": { "year": 1447, "month": 7, "day": 27 },
"gregorian": "2026-01-16",
"weekday": "Friday"
}
]
}Events covered
islamic_new_year, ashura, mawlid, isra_miraj, nisfu_shaban,
ramadan_start, nuzulul_quran, laylatul_qadr, eid_fitr, arafah,
eid_adha, tashreeq.