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

A month of prayer times

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

The current month, or the next one (on March 30, next is April). No arbitrary month, year or range.

Path parameters

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

Query parameters

Query parameters
Name	Type	Description
`month`	current \| next · optional	Which month: `current` (the default) or `next`.

Response

The days of the month.

Response fields
Field	Description
`object` prayer_times_schedule	Always `prayer_times_schedule`.
`masjid` string	The masjid id.
`timezone` string	The masjid's IANA timezone.
`period` object	The days covered.
`period.start` string · YYYY-MM-DD	The first day.
`period.end` string · YYYY-MM-DD	The last day, included.
`data` object[]	The days, in order.
`data[].date` string · YYYY-MM-DD	The day, YYYY-MM-DD, in the masjid's timezone.
`data[].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.
`data[].hijri.year` integer	The Hijri year.
`data[].hijri.month` integer	The Hijri month, 1 (Muharram) to 12.
`data[].hijri.day` integer	The day of the Hijri month, 1 to 30.
`data[].sunrise` string · HH:mm	Sunrise, HH:MM: not a prayer, the end of the fajr window.
`data[].prayers` object	The five prayers.
`data[].prayers.fajr` object	The fajr prayer.
`data[].prayers.fajr.adhan` string · HH:mm	The fajr adhan, HH:MM in the masjid's timezone.
`data[].prayers.fajr.iqamah` string · HH:mm \| null	The fajr iqamah; null when the masjid supplies none, always for calculated times.
`data[].prayers.dhuhr` object	The dhuhr prayer.
`data[].prayers.dhuhr.adhan` string · HH:mm	The dhuhr adhan, HH:MM in the masjid's timezone.
`data[].prayers.dhuhr.iqamah` string · HH:mm \| null	The dhuhr iqamah; null when the masjid supplies none, always for calculated times.
`data[].prayers.asr` object	The asr prayer.
`data[].prayers.asr.adhan` string · HH:mm	The asr adhan, HH:MM in the masjid's timezone.
`data[].prayers.asr.iqamah` string · HH:mm \| null	The asr iqamah; null when the masjid supplies none, always for calculated times.
`data[].prayers.maghrib` object	The maghrib prayer.
`data[].prayers.maghrib.adhan` string · HH:mm	The maghrib adhan, HH:MM in the masjid's timezone.
`data[].prayers.maghrib.iqamah` string · HH:mm \| null	The maghrib iqamah; null when the masjid supplies none, always for calculated times.
`data[].prayers.isha` object	The isha prayer.
`data[].prayers.isha.adhan` string · HH:mm	The isha adhan, HH:MM in the masjid's timezone.
`data[].prayers.isha.iqamah` string · HH:mm \| null	The isha iqamah; null when the masjid supplies none, always for calculated times.
`data[].jumua` string[] \| null	The jumu'ah times on a Friday the masjid supplies them; null on other days.
`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/monthly" \
  -H "Authorization: Bearer $MASJIDBOX_KEY"

200 · PrayerTimesSchedule

{
  "data": [
    {
      "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_schedule",
  "period": {
    "end": "2026-10-15",
    "start": "2026-10-09"
  },
  "links": {
    "report": "https://hub.masjidbox.com/report/msj_abc123defg"
  },
  "source": {
    "status": "fresh",
    "type": "masjid"
  },
  "timezone": "Europe/London"
}