Digital Quran
  • Introduction
  • Standards & conventions
    • Quran
    • Naming convention
    • Translation files: description
    • Translation files: examples
    • Translation texts
    • Quranic Text Markup Language (QTML)
    • Code examples
  • Content & Releases
    • Quran text
    • Font (Kitab)
    • Meta data
    • Translations
    • Tafsirs
    • Word-by-word translations
  • FAQ
    • How can I contribute?
    • Why Quran Academy website has more data than Digital Quran?
    • What if I found a mistake or a typo in a translation?
    • Who is using this standard?
    • How can I use content?
  • API
    • Getting started
    • Authentication
    • Creating an application
    • Limits
    • Errors
    • Pagination
    • CORS
    • Public endpoints
      • Languages
      • Surahs
      • Ayahs
      • Words
      • Translations
  • Other
    • Contributors
Powered by GitBook
On this page
  • List ayahs of a specific surah
  • URL
  • Parameters
  • Response

Was this helpful?

  1. API
  2. Public endpoints

Ayahs

List ayahs of a specific surah

URL

GET /ayahs

Parameters

Name

Type

Description

Required

Default

surah_number

integer

The number of a surah.

Yes

None

include_arabic_text

boolean

Add text in arabic?

No

false

translations

string[]

Codes of translations.

No

None

start_ayah_number

integer

The number of the start ayah (if you want to get a range of ayahs).

No

None

end_ayah_number

integer

The number of the end ayah (if you want to get a range of ayahs).

No

None

Example:

{
    "surah_number": 1,
    "include_arabic_text": true,
    "translations": ["en-saheeh-international", "ru-abu-adel"]
}

Response

[
    {
        "surah_number": 1,
        "number": 1,
        "juz_number": 1,
        "hizb_number": 1,
        "rub_number": 1,
        "sajdah": false,
        "word_count": 4,
        "arabic_text": "بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ",
        "translations": {
            "en-saheeh-international": "In the name of Allah, the Entirely Merciful, the Especially Merciful.",
            "ru-abu-adel": "С именем Аллаха Милостивого, Милосердного!"
        }
    },
    {
        "surah_number": 1,
        "number": 2,
        "juz_number": 1,
        "hizb_number": 1,
        "rub_number": 1,
        "sajdah": false,
        "word_count": 4,
        "arabic_text": "الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ",
        "translations": {
            "en-saheeh-international": "(All) praise is (due) to Allah, Lord of the worlds -",
            "ru-abu-adel": "(Вся) хвала – (лишь одному) Аллаху, Господу миров [Господу всех творений],\n"
        }
    }
]
PreviousSurahsNextWords

Last updated 5 years ago

Was this helpful?