Get list of audio files of single recitation

Get list of audio files for a single recitation, in MP3 format.

Path Parameters

recitation_id number required

Recitation id

Query Parameters

fields string

Field of audio files, separated by commas (,).

chapter_number integer

Possible values: >= 1 and <= 114

If you want to get audio file of a specific chapter (surah).

juz_number integer

Possible values: >= 1 and <= 30

If you want to get audio file of a specific Juz.

page_number integer

Possible values: >= 1 and <= 604

If you want to get audio file of a Madani Muhsaf page

hizb_number integer

Possible values: >= 1 and <= 60

If you want to get audio file of a specific Hizb.

rub_el_hizb_number integer

Possible values: >= 1 and <= 240

If you want to get audio file of a specific Rub el Hizb.

verse_key string

If you want to get audio file of a specific verse (ayah), in the format chapter:verse (e.g. 1:1 -> Chapter 1, Verse 1).

Responses

• 200

---

application/json

Schema

Example (from schema)

response

---

Schema

audio_files object[] required
Array [
url string
duration number
format string
segments undefined[]
]
meta object
reciter_name string
recitation_style string nullable

{
  "audio_files": [
    {
      "url": "https://verses.quran.com/AbdulBaset/Mujawwad/mp3/001001.mp3",
      "duration": 6,
      "format": "mp3",
      "segments": [
        [
          [
            0,
            120,
            -1
          ],
          [
            120,
            420,
            0
          ],
          [
            540,
            810,
            1
          ],
          [
            1350,
            1006,
            2
          ],
          [
            2356,
            2454,
            3
          ],
          [
            4810,
            390,
            -1
          ]
        ]
      ]
    }
  ],
  "meta": {
    "reciter_name": "string",
    "recitation_style": "string"
  }
}

{
  "audio_files": [
    {
      "verse_key": "1:1",
      "url": "Alafasy/mp3/001001.mp3"
    },
    {
      "verse_key": "1:2",
      "url": "Alafasy/mp3/001002.mp3"
    },
    {
      "verse_key": "1:3",
      "url": "Alafasy/mp3/001003.mp3"
    },
    {
      "verse_key": "1:4",
      "url": "Alafasy/mp3/001004.mp3"
    },
    {
      "verse_key": "1:5",
      "url": "Alafasy/mp3/001005.mp3"
    },
    {
      "verse_key": "1:6",
      "url": "Alafasy/mp3/001006.mp3"
    },
    {
      "verse_key": "1:7",
      "url": "Alafasy/mp3/001007.mp3"
    }
  ],
  "meta": {
    "reciter_name": "Mishari Rashid al-`Afasy",
    "recitation_style": null
  }
}

Loading...