Skip to main content

Get Quran verses in a specific script​

Stream the complete Quran text in the requested script. Use the structural filters to limit results to a chapter, juz, hizb, rub el hizb, manzil, ruku, or page.

Path Parameters
    script string required

    Possible values: [uthmani, uthmani_simple, uthmani_tajweed, indopak, indopak_nastaleeq, imlaei, imlaei_simple, qpc_hafs, qpc_nastaleeq, code_v1, code_v2, v1_image]

    Script identifier for the response payload. Supported values: uthmani, uthmani_simple, uthmani_tajweed, indopak, indopak_nastaleeq, imlaei, imlaei_simple, qpc_hafs, qpc_nastaleeq, code_v1, code_v2, v1_image.

Query Parameters
    chapter_number integer

    Possible values: >= 1 and <= 114

    Filter verses to a specific surah.

    juz_number integer

    Possible values: >= 1 and <= 30

    Filter verses to a specific juz.

    page_number integer

    Possible values: >= 1 and <= 604

    Filter verses to a Madani Mushaf page.

    hizb_number integer

    Possible values: >= 1 and <= 60

    Filter verses to a specific hizb.

    rub_el_hizb_number integer

    Possible values: >= 1 and <= 240

    Filter verses to a specific rub el hizb.

    manzil_number integer

    Possible values: >= 1 and <= 7

    Filter verses to a specific manzil.

    ruku_number integer

    Possible values: >= 1 and <= 558

    Filter verses to a specific ruku.

    verse_key string

    Fetch a single ayah by its chapter:verse key.

    page integer

    Default value: 1

    Result page number (pagination).

    per_page integer

    Possible values: >= 1 and <= 50

    Default value: 10

    Records per page (maximum 50).

Responses

Successful response

Schema
    verses object[]
  • Array [
    • id integer required
    chapter_id integer

    Chapter number of this verse

    verse_number integer required
    verse_key string required

    key of the verse, key is generated using chapter number and ayah number. e.g 1:1 is first ayah of first surah.

    verse_index integer
    text_uthmani string

    Ayah text in Uthmani Script.

    Uthmani script is an old-fashion script used by the third Caliph, Uthman, to produce the first standard quran manuscript.

    text_uthmani_simple string

    Uthmani script diacritic marks

    text_imlaei string

    Ayah text in Imla'ei script.

    Imla'ei script, is the modern Arabic writing style which is currently in use.

    text_imlaei_simple string
    text_indopak string
    text_uthmani_tajweed string
    juz_number integer required
    hizb_number integer required
    rub_number integer required
    page_number integer required

    Possible values: >= 1 and <= 604

    page_number is deprecated, please use v1_page instead.

    ruku_number integer
    manzil_number integer
    image_url string
    image_width integer
    words object[]
  • Array [
    • id integer
    position integer required

    Word position within ayah

    text_uthmani string

    Word text in Uthmanic script

    text_indopak string
    text_imlaei string

    Word text in simple/Imlaei script

    verse_key string
    page_number integer

    Possible values: >= 1 and <= 604

    page_number is deprecated, please use v1_page instead.

    line_number integer

    Line number in the Mushaf for this word

    audio_url string required
    location string
    char_type_name string required
    code_v1 string

    glyph code that you can use to render the word using QCF v1 font.

    code_v2 string

    glyph code that you can use to render the word using QCF v2 font.

    translation object required
    text string
    language_name string
    transliteration object required
    text string
    language_name string
    v1_page integer

    Possible values: >= 1 and <= 604

    Madani Mushaf Page number for v1 font. If v1_page value is 2, that means you'll use page 2 font file to render this word using v1 glyph codes.

    v2_page integer

    Possible values: >= 1 and <= 604

    Madani Mushaf Page number for v2 font. If v2_page value is 2, that means you'll use page 2 font file to render this ayah using v2 glyph codes.

  • ]
    • audio object
    url string
    duration number
    format string
    segments object[]
    translations object[]
  • Array [
    • resource_id integer required
    resource_name string
    id integer
    text string required

    Text of the translation, text could have HTML tags for formatting and footnotes.

    verse_id integer
    language_id integer
    language_name string
    verse_key string
    chapter_id integer
    verse_number integer
    juz_number integer
    hizb_number integer
    rub_number integer
    page_number integer
  • ]
    • code_v1 string

    Glyphs codes for QCF v1 fonts

    code_v2 string

    Glyphs codes for QCF v2 fonts

    v1_page integer

    Possible values: >= 1 and <= 604

    Madani Mushaf Page number for v1 font. If v1_page value is 2, that means you'll use page 2 font file to render this ayah using v1 glyph codes.

    v2_page integer

    Possible values: >= 1 and <= 604

    Madani Mushaf Page number for v2 font. If v2_page value is 2, that means you'll use page 2 font file to render this ayah using v2 glyph codes.

  • ]
    • pagination object
    per_page integer

    Entries per api call

    current_page integer
    next_page integer

    Next page in paginated result

    total_pages= integer

    Total number of pages

    total_records= integer
Loading...