API Documentation
Access prayer times, news, events, Islamic content, and more through our free public API. No authentication required. Some endpoints are feature-gated — check /api/site-settings/public-features for availability.
No Auth Required
All endpoints are public
JSON Responses
Clean, structured data
AI-Friendly
Works with AI assistants
Prayer Times
Get daily prayer times and schedules for our mosque locations.
/api/prayer-timesList all locations with prayer times configured
/api/prayer-times/{location_slug}/todayGet today's prayer times for a specific location
/api/prayer-times/{location_slug}/date/{date}Get prayer times for a specific date (YYYY-MM-DD format)
/api/prayer-times/{location_slug}/monthGet prayer times for an entire month
Parameters
yearrequiredYear (e.g., 2026)monthrequiredMonth number 1-12/api/prayer-times/{location_slug}/ramadanGet Ramadan timetable with suhoor/iftar times
Parameters
yearYear (optional, defaults to current year)News & Articles
Access published news articles and announcements.
/api/newsList published articles with pagination
Parameters
pagePage number (default: 1)page_sizeItems per page (default: 20, max: 50)category_idFilter by category IDsearchSearch in title and contentfeaturedFilter featured articles only/api/news/slug/{slug}Get a single article by its URL slug
/api/news/categoriesList all news categories
Events
Browse upcoming and past community events.
/api/eventsList published events with pagination
Parameters
pagePage numberpage_sizeItems per pageupcomingShow only future events (true/false)categoryFilter by category (community, educational, charity, religious, youth)featured_onlyShow only featured eventssearchSearch in title and description/api/events/slug/{slug}Get event details by URL slug
Charity Projects
View active fundraising campaigns and charity projects.
/api/projectsList active charity projects
Parameters
pagePage numberpage_sizeItems per pagecategoryFilter by categorysearchSearch projects/api/projects/featuredGet featured projects for display
Parameters
limitNumber of projects to return/api/projects/slug/{slug}Get project details by URL slug
/api/projects/{project_id}/statsGet donation statistics for a project
Shop Products
Browse products available in our community shop.
/api/shopList active products
Parameters
pagePage numberpage_sizeItems per pagetypeProduct type (physical, external, preorder, interest)categoryFilter by categoryfeaturedFeatured products onlysearchSearch products/api/shop/{slug}Get product details by URL slug
Locations & Venues
Information about our mosque and community centre locations.
/api/locationsList all active locations
/api/locations/mainGet the main mosque/centre details
/api/locations/{slug}Get location details by URL slug
/api/locations/bookableList locations with room booking enabled
Room Booking
Check availability for room and hall bookings.
/api/bookings/availabilityCheck available time slots for a bookable unit
Parameters
unit_idrequiredThe bookable unit IDdaterequiredStart date (YYYY-MM-DD)endEnd date for range query (max 31 days)Donations
Public donation statistics.
/api/donations/public-statsGet public donation statistics (anonymized)
Announcements
Public announcements and website banners.
/api/announcementsList active public announcements (PSAs)
/api/special-announcements/websiteGet the active website banner announcement, if any
Site Settings
Public configuration and feature availability.
/api/site-settings/public-featuresList publicly enabled features (e.g. radio, lms, ibadah, oms)
Search
Search across all public content.
/api/searchSearch across news, events, projects, and more. Returns results as an unauthenticated user.
Parameters
queryrequiredSearch query stringtypesArray of content types to search (news, events, projects, shop, locations)limitMax results per type (default: 5)Radio
Requires "radio" featureCommunity radio schedules, live sessions, and recordings. Requires the "radio" feature to be enabled.
/api/radio/schedules/upcomingGet upcoming radio schedule for the next 24 hours
/api/radio/sessions/currentGet the currently live radio session, if any
/api/radio/recordings/publicBrowse past radio recordings (if recordings are enabled)
LMS (Learning)
Requires "lms" featureBrowse classes, categories, and verify certificates. Requires the "lms" feature to be enabled (except certificate verification).
/api/lms/classes/publicList publicly available classes
Parameters
pagePage number (default: 1)page_sizeItems per page (default: 20)category_idFilter by category IDsearchSearch in class name and description/api/lms/classes/public/{identifier}Get class details by ID or slug
/api/lms/categories/publicList class categories
/api/lms/certificates/verify/{code}Verify a certificate by its code (always available, no feature gate)
Ibadah (Worship)
Requires "ibadah" featureDuas, hadith collections, Quran, readings, and community campaigns. Requires the "ibadah" feature to be enabled.
/api/ibadah/duas/public/categoriesList dua categories
/api/ibadah/duas/publicList published duas
/api/ibadah/duas/public/{id}Get a single dua by ID
/api/ibadah/hadith/public/collectionsList hadith collections
/api/ibadah/hadith/public/collections/{slug}Get collection details with books
/api/ibadah/hadith/public/collections/{slug}/books/{num}Get hadiths within a specific book
/api/ibadah/hadith/public/collections/{slug}/hadiths/{num}Get a single hadith by number
/api/ibadah/hadith/public/searchSearch hadith text (English and Arabic)
Parameters
qrequiredSearch querycollectionFilter by collection slugpagePage numberpage_sizeItems per page/api/ibadah/readings/publicBrowse public readings
/api/ibadah/readings/public/{id}Get a single reading by ID
/api/ibadah/quran/public/surahsList all 114 surahs
/api/ibadah/quran/public/surahs/{num}Get full surah with ayahs
/api/ibadah/quran/public/pages/{num}Get mushaf page with word-level data
/api/ibadah/quran/public/juz/{num}Get all ayahs in a juz (1-30)
/api/ibadah/campaigns/publicList active public campaigns
/api/ibadah/campaigns/public/featuredGet the featured campaign
/api/ibadah/campaigns/public/{id}Get campaign details with activities
/api/ibadah/campaigns/public/{id}/contributorsGet per-activity contributor lists for a campaign
/api/ibadah/campaigns/public/{id}/breakdownGet activity breakdown by time period
OMS (Community Service)
Requires "oms" featureCommunity boards with volunteer slots and drives. Requires the "oms" feature to be enabled.
/api/oms/boards/publicList published community boards
/api/oms/boards/public/{id_or_slug}Get board details with groups, slots, and pledges
/api/oms/drives/publicList active public volunteer drives
/api/oms/drives/public/{id}Get drive details
Example Response
Prayer times response from GET /api/prayer-times/al-jamia-al-zahra/today
{
"date": "2026-01-19",
"day_name": "Monday",
"fajr_start": "06:07",
"fajr_jamaat": "07:00",
"sunrise": "08:13",
"dhuhr_start": "12:22",
"dhuhr_jamaat": "13:00",
"asr_start": "14:37",
"asr_jamaat": "15:00",
"maghrib_start": "16:30",
"maghrib_jamaat": "16:30",
"isha_start": "17:52",
"isha_jamaat": "18:30",
"jummah_time": "13:00",
"is_ramadan": false,
"suhoor_end": null,
"iftar": null
}Need Help?
If you have questions about the API or need assistance integrating with our services, please get in touch.
Contact Us