Docs / Reference · public.prayerTimes.today · generated from openapi.json

Today's prayer times

GET/v1/masjids/{id}/prayer-times

The prayer times of the current date in the masjid's timezone: wall-clock times, never converted to UTC.

Path parameters

Path parameters
Name	Type	Description
`id`	string · required	The masjid id, `msj_…`, as search, nearby or a previous read gave it.

Response

Today's prayer times.

Response fields
Field	Description
`object` prayer_times	Always `prayer_times`.
`masjid` string	The masjid id.
`date` string · YYYY-MM-DD	The day, YYYY-MM-DD, in the masjid's timezone.
`hijri` object · optional	The day in the Hijri calendar, as the masjid dates it (its own Hijri setting, else its country's). Absent when Masjidbox has no Hijri date for the day.
`hijri.year` integer	The Hijri year.
`hijri.month` integer	The Hijri month, 1 (Muharram) to 12.
`hijri.day` integer	The day of the Hijri month, 1 to 30.
`sunrise` string · HH:mm	Sunrise, HH:MM: not a prayer, the end of the fajr window.
`prayers` object	The five prayers.
`prayers.fajr` object	The fajr prayer.
`prayers.fajr.adhan` string · HH:mm	The fajr adhan, HH:MM in the masjid's timezone.
`prayers.fajr.iqamah` string · HH:mm \| null	The fajr iqamah; null when the masjid supplies none, always for calculated times.
`prayers.dhuhr` object	The dhuhr prayer.
`prayers.dhuhr.adhan` string · HH:mm	The dhuhr adhan, HH:MM in the masjid's timezone.
`prayers.dhuhr.iqamah` string · HH:mm \| null	The dhuhr iqamah; null when the masjid supplies none, always for calculated times.
`prayers.asr` object	The asr prayer.
`prayers.asr.adhan` string · HH:mm	The asr adhan, HH:MM in the masjid's timezone.
`prayers.asr.iqamah` string · HH:mm \| null	The asr iqamah; null when the masjid supplies none, always for calculated times.
`prayers.maghrib` object	The maghrib prayer.
`prayers.maghrib.adhan` string · HH:mm	The maghrib adhan, HH:MM in the masjid's timezone.
`prayers.maghrib.iqamah` string · HH:mm \| null	The maghrib iqamah; null when the masjid supplies none, always for calculated times.
`prayers.isha` object	The isha prayer.
`prayers.isha.adhan` string · HH:mm	The isha adhan, HH:MM in the masjid's timezone.
`prayers.isha.iqamah` string · HH:mm \| null	The isha iqamah; null when the masjid supplies none, always for calculated times.
`jumua` string[] \| null	The jumu'ah times on a Friday the masjid supplies them; null on other days.
`timezone` string	The masjid's IANA timezone.
`source` object	Where the times come from.
`source.type` masjid \| calculated	Supplied or managed by the masjid, or calculated by Masjidbox.
`source.status` fresh \| stale	Masjidbox's assessment of the underlying data; a `calculated` timetable is always `fresh`.
`links` object	The masjid's links for these times.
`links.report` string	Where a user reports an error in this masjid's times. Always present: the page takes the report, or invites the masjid to claim its page when nobody manages it yet. Link a "Report an error" next to the attribution. To preselect the form, append any of `?prayer=&kind=&day=` to the link: `prayer` is one of `fajr`, `dhuhr`, `asr`, `maghrib`, `isha`, `jumua` or `other`; `kind` is `adhan` or `iqamah`; `day` is the day the time is wrong, `YYYY-MM-DD`, from a week before the masjid's today to 30 days after.

Errors

curl

curl "https://hub.masjidbox.com/v1/masjids/msj_abc123defg/prayer-times" \
  -H "Authorization: Bearer $MASJIDBOX_KEY"

200 · PrayerTimes

{
  "date": "2026-10-09",
  "hijri": {
    "day": 17,
    "month": 4,
    "year": 1448
  },
  "jumua": [
    "13:00",
    "14:00"
  ],
  "prayers": {
    "asr": {
      "adhan": "16:02",
      "iqamah": "16:30"
    },
    "dhuhr": {
      "adhan": "12:52",
      "iqamah": "13:30"
    },
    "fajr": {
      "adhan": "05:31",
      "iqamah": "06:00"
    },
    "isha": {
      "adhan": "20:01",
      "iqamah": "20:30"
    },
    "maghrib": {
      "adhan": "18:32",
      "iqamah": "18:37"
    }
  },
  "sunrise": "07:12",
  "masjid": "msj_abc123defg",
  "object": "prayer_times",
  "links": {
    "report": "https://hub.masjidbox.com/report/msj_abc123defg"
  },
  "source": {
    "status": "fresh",
    "type": "masjid"
  },
  "timezone": "Europe/London"
}