API Indonesia logoAPI Indonesia

Core Products

More Products

See All APIs
New

Realtime Earthquake API

BMKG earthquake data, updated hourly.

Learn more
API Reference

Hijri Calendar

Gregorian ↔ Hijri date conversion based on the Indonesian Hijri Calendar (Kemenag, MABIMS). Static 2026 data.

Sign Up FreeView Full Docs
Main endpoint
GET https://use.apiindonesia.id/api/v1/hijriah/konversi
Endpoints
2
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Gregorian ↔ Hijri date conversion based on the Indonesian Hijri Calendar (Kemenag, MABIMS). Static 2026 data.

Coverage
2

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/hijriah/konversi

Convert one Gregorian date to Hijri.

When should you use it?

The Hijri Calendar API fits Muslim apps, calendars, HR, media, and event products that need Gregorian-Hijri conversion based on Indonesia’s Kemenag Hijri calendar.

The app needs to show official Hijri dates for the Indonesian context.

Calendar products need reminders for Ramadan, Eid al-Fitr, or Islamic observances.

HR or payroll documents want Hijri dates alongside Gregorian dates.

Data coverage follows the years available in the system. Check target-year availability before promising long-range calendar features.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Muslim lifestyle apps: show the official Indonesian Hijri date alongside the Gregorian date.
  • Islamic ed-tech & content: auto-calculate key Islamic dates (Ramadan, Eid al-Fitr).
  • Calendar & event apps: schedule reminders for Islamic holidays per the official calendar.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/hijriah/konversi?tanggal=2026-07-11" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": { "gregorian_date": "2026-07-11", "hijri_formatted": "26 Muharram 1448 H" },
  "meta": { "disclaimer": "Berdasarkan Kalender Hijriah Indonesia (hisab MABIMS)..." }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Sign upSee plans

Hijri Calendar API questions

Which Hijri calendar is used?

The Indonesian Hijri Calendar from Kemenag (MABIMS criteria). The static data currently available covers 2026.

How do I convert a Gregorian date to Hijri?

Use GET /api/v1/hijriah/konversi?tanggal=YYYY-MM-DD.

Can I get a full-year calendar?

Yes, with GET /api/v1/hijriah/kalender?tahun=2026.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization