About
Supply a location — as coordinates, a city name, a timezone string, or a Google Plus Code — and the API responds with the current Hijri date in plain text, calculated against the local midnight for that location.
No authentication required. No JSON envelope. Just the date.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
lat + lon |
float | Decimal latitude and longitude. Both required together. |
city |
string | City name. Combine with country for accuracy. |
country |
string | Country name or ISO code. Optional — used with city. |
timezone |
string | IANA timezone identifier, e.g. Africa/Johannesburg. |
pluscode |
string | Google Plus Code (Open Location Code), e.g. 4FRW3J2V+PQ. |
date |
string | Gregorian date to convert, in YYYY-MM-DD format. Optional — defaults to today's date in the resolved timezone. |
Provide at least one location parameter. Location parameters are resolved in this
priority order:
timezone → lat+lon → pluscode
→ city. The date parameter is independent and optional.
Endpoints
| Path | Description |
|---|---|
GET / |
Returns the Hijri date for the given location parameters. |
GET /date |
Alias for /. |
GET /health |
Returns ok — for uptime monitoring. |
Response
Always text/plain, UTF-8. One line. No trailing markup.
Examples
Latitude & Longitude — Cape Town
https://api.hijri.co.za/date?lat=-33.92&lon=18.42 6 Dhu al-Qi'dah 1446
City & Country
https://api.hijri.co.za/date?city=Makkah&country=Saudi+Arabia 6 Dhu al-Qi'dah 1446
IANA Timezone
https://api.hijri.co.za/date?timezone=Asia/Karachi 6 Dhu al-Qi'dah 1446
Google Plus Code
https://api.hijri.co.za/date?pluscode=4FRW3J2V%2BPQ 6 Dhu al-Qi'dah 1446
Specific Gregorian Date — Timezone + Date
https://api.hijri.co.za/date?timezone=Africa/Johannesburg&date=2025-03-01 1 Ramadan 1446
Error response (400)
https://api.hijri.co.za/date?timezone=Rubbish Error: Unknown timezone: 'Rubbish'. Use an IANA timezone string.
Command-line
curl
curl "https://api.hijri.co.za/date?timezone=Africa/Johannesburg"