QuickstartTryBlogFAQGitHub

MABIMS Calendar API for Indonesia

Integrate the MABIMS Hijri calendar into your website or app. Single endpoint, no authentication, official Kemenag data.

QuickstartTry it
terminal
$
$█
Don't Use the Wrong Hijri Calendar
Almost all Hijri calendar APIs use Umm al-Qura (Saudi) as default. That calendar follows Saudi authority, not Indonesia's official Kemenag decision. The result? Your app's dates can be ±1 day off from local moon sighting.
 Umm al-Qura
1 Ramadhan 1447 H
18 February 2026
What your app shows
 MABIMS
30 Sya'ban 1447 H
18 February 2026
What's seen in Indonesia's sky
11 Mar 2024MABIMS30 Sya'ban 1445 HUmm al-Qura1 Ramadhan 1445 H🌙 Different fasting start
9 May 2024MABIMS30 Syawal 1445 HUmm al-Qura1 Dzulqa'dah 1445 H
5 Aug 2024MABIMS30 Muharram 1446 HUmm al-Qura1 Safar 1446 H
2 Dec 2024MABIMS30 Jumadilakhir 1446 HUmm al-Qura1 Rajab 1446 H
30 Mar 2025MABIMS30 Ramadhan 1446 HUmm al-Qura1 Syawal 1446 H🎉 Different Eid
26 Jun 2025MABIMS30 Dzulhijjah 1446 HUmm al-Qura1 Muharram 1447 H✨ Different new year 1447
24 Aug 2025MABIMS30 Safar 1447 HUmm al-Qura1 Rabiulawal 1447 H
18 Feb 2026MABIMS30 Sya'ban 1447 HUmm al-Qura1 Ramadhan 1447 H🌙 Different fasting start
15 Jul 2026MABIMS30 Muharram 1448 HUmm al-Qura1 Safar 1448 H
12 Sep 2026MABIMS30 Rabiulawal 1448 HUmm al-Qura1 Rabiulakhir 1448 H
In 2024–2026 alone, there are 418 days that differ from Umm al-Qura.
See for Yourself
On the surface all Hijri APIs look the same. The difference shows on important days: fasting start, Eid al-Fitr, 1 Muharram.
MABIMSUmm al-QuraTurkey Global
SourceKemenag RISaudi GovernmentTurkish Government
MethodNeo MABIMS rukyahSaudi rukyahPure astronomy
Accuracy for Indonesia✓ Official±1 day±1 day
Regional CoverageID, MY, SGSaudi ArabiaGlobal non-specific
Beyond Table CoverageNeo MABIMS computationUmm al-Qura computationPure astronomy
AuthenticationNot requiredProvider-dependentProvider-dependent
Time to Switch to MABIMS
No API key, no registration. All you change is the data source.
Official Kemenag Data
Uses the official calendar table from Indonesia's Ministry of Religious Affairs, not Saudi authority.
No Authentication
Just call the endpoint. No API key needed, no registration required.
Wide Coverage
Table data for 2024–2026, forward computation up to 2053.
Open Source
Source code on GitHub. Transparent, verifiable, contributions always welcome.
Timezone-Aware
Supports all IANA timezones. Defaults to Asia/Jakarta, overridable.
Smart Fallback
Beyond table coverage, computes using Neo MABIMS criteria (moon ≥ 3°, elongation ≥ 6.4°).
Hilal visibility chart — the evening determining the start of Ramadan 1447 H in Sabang
Hilal Visualization
Not just data — we also present hilal visibility imagery. The /hilal/viz endpoint renders a 720×1280 sky chart for the sighting evening: moon position, crescent orientation facing the sun, verdict (VISIBLE / NOT VISIBLE), and criteria table.
Everything is computed using MABIMS criteria at Sabang's coordinates, to estimate what the Indonesian government may announce.
GET/api/v1/hilal/viz?month=1&year=1448
Built for Developers
Clean REST API, consistent JSON responses, full documentation.
GET/todayToday's Hijri date
GET/today/{date}Specific date (CDN-cacheable)
GET/convertSingle date conversion (both directions)
GET/rangeBulk conversion (≤400 days)
GET/monthMonthly calendar grid
GET/eventsIslamic holidays (Ramadan, Eid al-Fitr/Adha, etc.)
GET/hilal/infoHilal visibility: criteria data
GET/hilal/viz720×1280 sky chart PNG
GET/metaData coverage & status info
View Full API Reference
Get Started in 1 Minute
No registration needed. Just call this endpoint:
curl "https://api.mabims.dev/api/v1/today"
QuickstartTry it
View integration tutorial →