QuickstartCobaKalenderBlogGitHub

MABIMS Calendar API for Indonesia

Integrate the MABIMS Hijri calendar into your website or app. Single endpoint, no authentication, data from publicly available Kemenag tables.

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
Indonesian Hijri Calendar, One API
MABIMS.dev is a free open-source API that provides an ecosystem for the Indonesian Hijri calendar. Get today's Hijri date, date conversion tools, monthly and yearly calendars, hilal visibility data, and Islamic event dates. All based on MABIMS criteria.
Based on Kemenag Data
Uses publicly available calendar tables 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 2023–2026, forward computation to 2100 and retro back to 1945.
Open Source
Source code on GitHub. Transparent, verifiable, contributions always welcome.
Monthly & Yearly Calendars
The /month and /year endpoints. All days in a month or a full year.
JavaScript SDK
Offline-first npm package. Date conversion, full months, hilal data, all without an API key.
Learn more about MABIMS.dev
Hilal visibility chart: the evening determining 1 Rajab 1448 H, decided at TuapejatIndonesia hilal visibility map: the evening determining 1 Rajab 1448 H
Hilal Visualization
Not just data; we also present hilal visibility imagery. The /hilal/viz endpoint renders a 720×1280 sky chart and/hilal/map renders an archipelago visibility map for the sighting evening: moon position, crescent orientation facing the sun, verdict (MEMENUHI KRITERIA / TIDAK MEMENUHI / MENDEKATI BATAS), and criteria table.
Everything is computed using the same Neo MABIMS criteria as the computed table; evaluated at coastal observation points across Indonesia, with the chart naming the deciding site. These are estimates, not official announcements.
GET/api/v1/hilal/viz?month=7&year=1448
GET/api/v1/hilal/map?month=7&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 (≤45 days)
GET/monthMonthly calendar grid
GET/yearFull year calendar grid (12 months)
GET/eventsIslamic holidays (Ramadan, Eid al-Fitr/Adha, etc.)
GET/hilal/infoHilal visibility: criteria data
GET/hilal/viz720×1280 sky chart PNG
GET/hilal/map720×1280 visibility map 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 →