Public APIs · No auth required
For developers

Developer APIs

Free, public REST APIs for Islamic tools. No API keys, no sign-up. Just make a request.

Hijri Calendar Jummal / Abjad Quran Search

Hijri Calendar

api.azsys.dev

Date conversion, month calendars, Islamic events

No auth 30 req/s

Jummal Calculator

api.azsys.dev

Abjad numerical value of Arabic text

No auth 60 req/s

Quran Search

quran.azizwares.com

Search ayahs, list surahs, diacritics-aware

No auth

Hijri Calendar API

Base URL: https://api.azsys.dev/v1 · Rate limit: 30 req/s

GET /hijri/today No auth

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-DD No auth

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-DD No auth

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=10 No auth

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=9 No auth

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 · 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.

GET /jummal?text=... No auth

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

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

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 /surah No auth

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} No auth

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} No auth

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."
}
Higher limits

Get an API key

Create a free account for authenticated access with higher rate limits and usage analytics.

Create free account
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