Skip to main content

List Qira'at readers​

Get the Qira'at readers (the reciters whose readings are compared), ordered by position. Optionally embed each reader's transmitters with include=transmitters. The reader biography is included in the bio object whenever one exists for the requested language. Requires the qiraat.read scope (or the parent qiraat scope); a token with only the content scope receives 403 with type: insufficient_scope. Qira'at endpoints are available in production only; they are not available in the prelive environment.

Query Parameters
    include string

    Comma-separated list of optional sections. Use transmitters to embed each reader's transmitters. Biographies (bio) are always returned when available.

    language string

    Default value: en

    Language ISO code for translated names, translations, and explanations. Defaults to en. An unknown code resolves to en. Content that is missing in a language other than en or ar falls back to English; ar does not fall back.

Responses

Successful response


Schema
    readers object[] required
  • Array [
  • id integer required
    name string required
    abbreviation string
    death_year_hijri integer nullable
    death_year_gregorian integer nullable
    position integer
    translated_name string nullable

    Reader name in the requested language, when available.

    transmitters object[]

    Present when include=transmitters is requested, and always on the single-reader endpoint.

  • Array [
  • id integer required
    name string required
    abbreviation string
    is_primary boolean
  • ]
  • bio object

    Reader biography in the requested language, when available.

    text string
    short_text string

    Only present on the single-reader endpoint.

  • ]
  • meta object required
    total integer required
Loading...