Docs / Reference · public.jumuaTimes.retrieve · generated from openapi.json

The next jumu'ah services

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

The jumu'ah services of the next Friday in the masjid's timezone (today when today is Friday). times is null when the masjid supplies none.

Path parameters

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

Response

The next Friday's services.

Response fields
Field	Description
`object` jumua_times	Always `jumua_times`.
`masjid` string	The masjid id.
`date` string · YYYY-MM-DD	The Friday, in the masjid's timezone.
`timezone` string	The masjid's IANA timezone.
`times` object[] \| null	The services, in order; null when the masjid supplies none.
`times[].time` string · HH:mm	A service, HH:MM.
`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/jumua-times" \
  -H "Authorization: Bearer $MASJIDBOX_KEY"

200 · JumuaTimes

{
  "date": "2026-10-09",
  "masjid": "msj_abc123defg",
  "object": "jumua_times",
  "links": {
    "report": "https://hub.masjidbox.com/report/msj_abc123defg"
  },
  "source": {
    "status": "fresh",
    "type": "masjid"
  },
  "times": [
    {
      "time": "13:00"
    },
    {
      "time": "14:00"
    }
  ],
  "timezone": "Europe/London"
}