Skip to content

Data Sources

Calendar data is sourced from data published publicly by the Ministry of Religious Affairs of the Republic of Indonesia (Kemenag RI), the MABIMS calendar tables issued annually.

Property Value
Source Ministry of Religious Affairs of the Republic of Indonesia, Hijri Calendar
Original format PDF
Table coverage 2023-01-23 → 2027-12-31

Beyond table coverage, the API computes dates using Neo MABIMS criteria (see also the official government announcement via Setkab):

Parameter Threshold
Moon altitude (topocentric, refraction-corrected) ≥ 3.0°
Elongation (geocentric) ≥ 6.4°
Observation points 25 coastal sites across Indonesia, fulfilled at any single point → 29-day month (site list)
Reference time At each site’s local sunset (day 29)

The map card (/hilal/map) uses the following geographic data:

Layer Source License
Indonesian landmass + province borders superpikar/indonesia-geojson per source repo
Surrounding countries Natural Earth 1:110m admin-0 Public domain
Display points (95) derived from a 126-city list + the 25 MABIMS observation sites —

Dates before 2023-01-23 were never produced under the Neo MABIMS criteria (introduced in 2022). Passing retro=true unlocks computed dates below the curated table down to 1945-01-01, tagged source: "mabims-retro" with a warning that these are a retrospective projection, not official data.

Calendar data is sourced from Indonesian government publications for public use. API source code is licensed under the MIT License.