Temporarily offline
For developers

Developer APIs

Free, public REST APIs for Islamic tools — Hijri calendar conversion, Abjad numerology, and Quran search.

These endpoints are not currently serving traffic.

We lost the host these APIs ran on and are rebuilding the platform. The reference below documents the intended contract, so treat it as a specification rather than a live service for now. Tell us if you were using one and we'll prioritise bringing it back and let you know when it's up.

Hijri Calendar Jummal / Abjad Quran Search

Hijri Calendar

api.azsys.dev

Date conversion, month calendars, Islamic events

Offline 30 req/s

Jummal Calculator

api.azsys.dev

Abjad numerical value of Arabic text

Offline 60 req/s

Quran Search

quran.azizwares.com

Search ayahs, list surahs, diacritics-aware

Offline

Hijri Calendar API

Base URL: https://api.azsys.dev/v1 · currently offline

GET /hijri/todayOffline

Get today's Hijri date with Arabic and English labels.

curl 
curl https://api.azsys.dev/v1/hijri/today
Response
{
  "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 /hijri/from-gregorian?date=YYYY-MM-DDOffline

Convert a Gregorian date to Hijri.

curl 
curl "https://api.azsys.dev/v1/hijri/from-gregorian?date=2026-03-25"
GET /gregorian/from-hijri?date=YYYY-MM-DDOffline

Convert a Hijri date to Gregorian.

curl 
curl "https://api.azsys.dev/v1/gregorian/from-hijri?date=1447-10-07"
GET /hijri/month?year=1447&month=10Offline

Get a full Hijri month calendar with Gregorian equivalents for each day.

curl 
curl "https://api.azsys.dev/v1/hijri/month?year=1447&month=10"
GET /hijri/events?month=9Offline

Get Islamic events for a Hijri month — Ramadan, Laylat al-Qadr, Eid al-Fitr, and more.

curl 
curl "https://api.azsys.dev/v1/hijri/events?month=9"

Jummal / Abjad Calculator API

Base URL: https://api.azsys.dev/v1 · currently offline

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.

GET /jummal?text=...Offline

Calculate the Abjad (Jummal) numerical value of Arabic text (max 1000 chars).

curl 
curl --get "https://api.azsys.dev/v1/jummal" \
  --data-urlencode "text=بسم الله"
Response
{
  "text": "بسم الله",
  "breakdown": [
    {"letter": "ب", "value": 2},
    {"letter": "س", "value": 60},
    {"letter": "م", "value": 40}
  ],
  "total": 168
}

Quran Search API

Base URL: https://quran.azizwares.com/api/v1 · currently offline

Diacritics-aware search: Searching for الرحمن will match ٱلرَّحْمَـٰنِ — full tashkeel is handled automatically.
GET /search?q=...&lang=arOffline

Search Quran ayahs in Arabic or English with diacritics-aware matching.

curl 
curl --get "https://quran.azizwares.com/api/v1/search" \
  --data-urlencode "q=الرحمن" \
  --data-urlencode "lang=ar"
GET /surahOffline

List all 114 surahs with Arabic name, English name, transliteration, and revelation type.

curl 
curl https://quran.azizwares.com/api/v1/surah
Response
{
  "count": 114,
  "surahs": [{"number": 1, "name": "سُورَةُ ٱلْفَاتِحَةِ", ...}]
}
GET /surah/{number}Offline

Get all ayahs of a surah by its number (1–114).

curl 
curl https://quran.azizwares.com/api/v1/surah/1
GET /ayah/{surah}/{ayah}Offline

Get a specific ayah by surah and ayah number, with Arabic text and English translation.

curl 
curl https://quran.azizwares.com/api/v1/ayah/1/1
Response
{
  "surah_number": 1,
  "surah_name": "سُورَةُ ٱلْفَاتِحَةِ",
  "ayah_number": 1,
  "arabic_text": "بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ",
  "english_text": "In the name of Allah, the Entirely Merciful, the Especially Merciful."
}
Need access

Want one of these back?

Tell us which endpoint you need and what you're building. We'll prioritise restoring it and email you when it's live.

Get in touch
Show & tell

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