# Iqamah Prayer Times API (api.iqamah.net)

> A free, keyless, CORS-open HTTP API for Islamic prayer (azaan/adhan) times anywhere on Earth, official national timetables where an authority publishes one, and the congregational (iqamah) and Jumu'ah times of mosques in the Iqamah network, as each mosque publishes them. Run by Iqamah (https://iqamah.org), the same data behind the Iqamah mobile, Apple Watch and Smart TV apps and the free mosque websites on iqamah.net. No sign-up, no ads, no paid tiers. Full documentation: https://api.iqamah.net/docs

## Endpoints (all GET, JSON unless noted)

- `/v1/times/{lat},{lon}/{yyyy-mm}.json` — a month of times for a point: fajr, sunrise, dhuhr, asr, maghrib, isha (local "HH:MM" plus UTC), Umm al-Qura Hijri date.
- `/v1/times/{lat},{lon}/{yyyy}.json` — a whole year (fetch once; it never changes).
- `/v1/ics/{lat},{lon}.ics` — a calendar feed of the next 60 days to subscribe to in Google Calendar, Apple Calendar or Outlook.
- `/v1/methods.json` — calculation methods, their angles, and the default method for each country.
- `/v1/mosque/{id}.json` — one mosque's iqamah and Jumu'ah times for every day held from today on. Each time keeps the mosque's own wording (`text`, e.g. "5 mins after adhan") and a 24-hour `time` when it is a clock time. Azaan comes from three sources side by side: the mosque's own, the official authority's (where one covers the mosque), and calculated. `status` is fresh, stale, queued or none.
- `/v1/mosques/near/{lat},{lon}.json` — mosques near a point, nearest first (`radius_km` 2, 5, 10, 25 or 50; `limit` up to 50; `q` filters names). Each result links to its `/v1/mosque/{id}.json`.
- `/embed/v1.js` — a browser script that calculates the same times locally with no further requests, plus a drop-in `<div data-iqamah-times>` widget.

## Parameters (times, calendar, mosque azaan)

- `method`: mwl, isna, egyptian, karachi, umm_al_qura, dubai, kuwait, qatar, singapore, turkey, tehran, moonsighting, jakim. Default: the usual method in the location's country.
- `asr`: standard (Shafi'i, Maliki, Hanbali) or hanafi. `highlat`: middle_of_the_night, seventh_of_the_night, twilight_angle.
- `fajr_angle`, `isha_angle`: custom twilight angles. `tz`: override the time zone.
- `lang`: en, ar, ur, bn, tr, ms, id, fr — adds prayer names in that language and a written Hijri date. JSON keys and time values never change with language.
- `source`: auto (official timetable where available, else calculated), official, or calculated.

## Official timetables

- Malaysia: JAKIM e-Solat, all 60 zones, refreshed weekly (attribution: Jabatan Kemajuan Islam Malaysia). More national authorities are planned.

## Using it well

- Every answer has one canonical URL (coordinates rounded to 2 decimals); other spellings get a 301. Cache what you fetch: a year file never changes.
- Uncached requests are rate-limited per client (HTTP 429 with Retry-After). Send a User-Agent naming your app.
- Errors are JSON with stable codes: `{"error":{"code":"bad_coordinates","message":"..."}}`.
- Times are computed with the open-source adhan library, the same one the Iqamah app uses.

## Links

- Documentation: https://api.iqamah.net/docs
- OpenAPI 3.1 description: https://api.iqamah.net/openapi.json
- Examples (JavaScript, Python, web, Home Assistant, ESP32): https://github.com/shakillangha/iqamah-prayer-times-api
- Terms of use: https://api.iqamah.net/docs#terms (free for any use; please credit Iqamah; show official timetables' attribution)
- Example month: https://api.iqamah.net/v1/times/41.88,-87.63/2026-11.json
- Example search: https://api.iqamah.net/v1/mosques/near/51.52,-0.07.json
- Iqamah apps and platform: https://iqamah.org/llms.txt
- Free mosque websites: https://admin.iqamah.net and https://about.iqamah.net
- Developer contact: mailto:api@iqamah.org · Abuse and blocks: mailto:support@iqamah.org