List all Surahs (Quran chapters)

get/surahs/

Request

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

ordering'asc' | 'desc'

Which field to use when ordering the results.

rasm_ol_mushafstring required

Slug of the Rasm Ol Mushaf to filter Surahs by. Common value: 'hafs'. Any string is accepted. (e.g. 'hafs', 'warsh', etc.)

searchstring

A search term.

idstring uuid required

mushaf_idstring uuid required

numberinteger required

period'makki' | 'madani' | '' | 'null' nullable

search_termsstring nullable

number_of_ayahsstring required

Sep 30, 2026d36549551285 Revision changes
- breaking
  removed the enum value u from the query request parameter rasm_ol_mushaf
Aug 25, 2026461db82462c7 Revision changes
- breaking
  removed the required property / from the response with the status