Skip to main content

By Hizb number​

Get all verses from a specific Hizb( half(1-60).

Path Parameters
    hizb_number integer required

    Possible values: >= 1 and <= 60

    Hizb number(1-60)

Query Parameters
    language string

    Default value: en

    Language to fetch word translation in specific language.

    words string

    Possible values: [true, false]

    Default value: true

    Include words of each ayah?

    0 or false will not include words.

    1 or true will include the words.

    translations string

    comma separated ids of translations to load for each ayah.

    audio integer

    Id of recitation if you want to load audio of each ayah.

    tafsirs string

    Comma separated ids of tafisrs to load for each ayah if you want to load tafisrs.

    word_fields string

    Comma separated list of word fields if you want to add more fields for each word.

    translation_fields string

    Comma separated list of translation fields if you want to add more fields for each translation.

    fields string

    comma separated list of ayah fields.

    page integer

    Default value: 1

    For paginating within the result

    per_page integer

    Possible values: >= 1 and <= 50

    Default value: 10

    records per api call, you can get maximum 50 records.

Responses
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
    sajdah_type nullable required
    sajdah_number nullable required
    page_number integer required

    Possible values: >= 1 and <= 604

    page_number is deperacted, please use v1_page instead.

    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 deperacted, please use v1_page instead.

    line_number integer

    Line number in the Muhsaf 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 Muhsaf 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 Muhsaf 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 undefined[]
    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 Muhsaf 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 Muhsaf 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

    Default value: 10

    Entries per api call

    current_page integer

    Default value: 1

    next_page integer

    Next page in paginated result

    total_pages= integer

    Total number of pages

    total_records= integer
GET /verses/by_hizb/:hizb_number

Request

Base URL
https://api.quran.com/api/v4
hizb_number — path required
language — query
words — query
translations — query
audio — query
tafsirs — query
word_fields — query
translation_fields — query
fields — query
page — query
per_page — query
curl / cURL
curl -L -X GET 'https://api.quran.com/api/v4/verses/by_hizb/:hizb_number' \
-H 'Accept: application/json'