Get Ayah recitations for specific Surah

Get list of audio files for a chapter (surah) from a reciter, specified by their Reciter ID (see https://api-docs.quran.com/docs/quran.com_versioned/chapter-reciters).

Path Parameters

recitation_id number required

Recitation ID, you can get list of all ayah by ayah recitations using this endpoint #endpoint:HLbauN2sdGitPQPPL

chapter_number number required

Possible values: >= 1 and <= 114

Responses

• 200

---

application/json

Schema

Example (from schema)

response

---

Schema

audio_files object[]
Array [
url string
duration number
format string
segments undefined[]
]
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

{
  "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
          ]
        ]
      ]
    }
  ],
  "pagination": {
    "per_page": 1,
    "current_page": 1,
    "next_page": 2,
    "total_pages=": 7,
    "total_records=": 7
  }
}

{
  "audio_files": [
    {
      "verse_key": "1:1",
      "url": "AbdulBaset/Mujawwad/mp3/001001.mp3"
    },
    {
      "verse_key": "1:2",
      "url": "AbdulBaset/Mujawwad/mp3/001002.mp3"
    },
    {
      "verse_key": "1:3",
      "url": "AbdulBaset/Mujawwad/mp3/001003.mp3"
    }
  ],
  "pagination": {
    "per_page": 10,
    "current_page": 1,
    "next_page": 2,
    "total_pages": 2,
    "total_records": 20
  }
}

GET /recitations/:recitation_id/by_chapter/:chapter_number

Request

Base URL

https://api.quran.com/api/v4

recitation_id — path required

chapter_number — path required

curl / cURL

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

ruby / Net::HTTP

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

csharp / RestSharp

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

php / cURL

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

java / OkHttp

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'

powershell / RestMethod

curl -L -X GET 'https://api.quran.com/api/v4/recitations/:recitation_id/by_chapter/:chapter_number' \
-H 'Accept: application/json'