Developer APIs
Free, public REST APIs for Islamic tools. No API keys, no sign-up. Just make a request.
Hijri Calendar
api.azsys.dev
Date conversion, month calendars, Islamic events
Jummal Calculator
api.azsys.dev
Abjad numerical value of Arabic text
Quran Search
quran.azizwares.com
Search ayahs, list surahs, diacritics-aware
Hijri Calendar API
Base URL: https://api.azsys.dev/v1 ยท Rate limit: 30 req/s
/hijri/today
No Auth
Get today's Hijri date with Arabic and English labels.
curl https://api.azsys.dev/v1/hijri/today
{
"hijri": "1447-10-07",
"year": 1447, "month": 10, "day": 7,
"month_name_arabic": "ุดููููุงู",
"month_name_english": "Shawwal",
"gregorian": "2026-03-25",
"day_of_week_arabic": "ุงูุฃุฑุจุนุงุก",
"day_of_week_english": "Wednesday"
}
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/hijri/from-gregorian?date=YYYY-MM-DD
No Auth
Convert a Gregorian date to Hijri.
curl "https://api.azsys.dev/v1/hijri/from-gregorian?date=2026-03-25"
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/gregorian/from-hijri?date=YYYY-MM-DD
No Auth
Convert a Hijri date to Gregorian.
curl "https://api.azsys.dev/v1/gregorian/from-hijri?date=1447-10-07"
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/hijri/month?year=1447&month=10
No Auth
Get a full Hijri month calendar with Gregorian equivalents for each day.
curl "https://api.azsys.dev/v1/hijri/month?year=1447&month=10"
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/hijri/events?month=9
No Auth
Get Islamic events for a Hijri month โ Ramadan, Laylat al-Qadr, Eid al-Fitr, and more.
curl "https://api.azsys.dev/v1/hijri/events?month=9"
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โJummal / Abjad Calculator API
Base URL: https://api.azsys.dev/v1 ยท Rate limit: 60 req/s
The Jummal (ุฌูู ููู) system assigns a numerical value to each Arabic letter, used in classical Islamic scholarship. This API calculates the Abjad value of any Arabic text with a per-letter breakdown.
/jummal?text=...
No Auth
Calculate the Abjad (Jummal) numerical value of Arabic text (max 1000 chars).
curl --get "https://api.azsys.dev/v1/jummal" \ --data-urlencode "text=ุจุณู ุงููู"
{
"text": "ุจุณู
ุงููู",
"breakdown": [
{"letter": "ุจ", "value": 2},
{"letter": "ุณ", "value": 60},
{"letter": "ู
", "value": 40}
],
"total": 168
}
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โQuran Search API
Base URL: https://quran.azizwares.com/api/v1
ุงูุฑุญู
ู will match ูฑูุฑููุญูู
ูููฐูู โ full tashkeel is handled automatically.
/search?q=...&lang=ar
No Auth
Search Quran ayahs in Arabic or English with diacritics-aware matching.
curl --get "https://quran.azizwares.com/api/v1/search" \ --data-urlencode "q=ุงูุฑุญู ู" \ --data-urlencode "lang=ar"
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/surah
No Auth
List all 114 surahs with Arabic name, English name, transliteration, and revelation type.
curl https://quran.azizwares.com/api/v1/surah
{
"count": 114,
"surahs": [{"number": 1, "name": "ุณููุฑูุฉู ูฑููููุงุชูุญูุฉู", ...}]
}
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/surah/{number}
No Auth
Get all ayahs of a surah by its number (1โ114).
curl https://quran.azizwares.com/api/v1/surah/1
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โ/ayah/{surah}/{ayah}
No Auth
Get a specific ayah by surah and ayah number, with Arabic text and English translation.
curl https://quran.azizwares.com/api/v1/ayah/1/1
{
"surah_number": 1,
"surah_name": "ุณููุฑูุฉู ูฑููููุงุชูุญูุฉู",
"ayah_number": 1,
"arabic_text": "ุจูุณูู
ู ูฑูููููู ูฑูุฑููุญูู
ููฐูู ูฑูุฑููุญููู
ู",
"english_text": "In the name of Allah, the Entirely Merciful, the Especially Merciful."
}
Get an API Key
Create a free account to get authenticated access to all our APIs with higher rate limits.
Create Free Account โBuilt something cool?
These APIs power the Jummal Calculator app and other AzizWares tools. If you integrate them, we'd love to hear about it.
Say hi โ