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 All Surahs
  • URL
  • Parameters
  • Response
  • Fetch a specific surah
  • URL
  • Parameters
  • Response

Was this helpful?

  1. API
  2. Public endpoints

Surahs

List All Surahs

URL

GET /surahs

Parameters

None.

Response

[
    {
        "number": 1,
        "basmala": false,
        "revelation_place": "meccan",
        "ayah_count": 7,
        "name": {
            "arabic": "الفاتحة",
            "translation": "The Opening",
            "transliteration": "Al-Fatiha"
        }
    },
    {
        "number": 2,
        "basmala": true,
        "revelation_place": "medinan",
        "ayah_count": 286,
        "name": {
            "arabic": "البقرة",
            "translation": "The Cow",
            "transliteration": "Al-Baqara"
        }
    }
]

Fetch a specific surah

URL

GET /surah

Parameters

Name

Type

Description

Required

surah_number

integer

The number of a surah.

Yes

Response

{
    "number": 1,
    "basmala": false,
    "revelation_place": "meccan",
    "ayah_count": 7,
    "name": {
        "arabic": "الفاتحة",
        "translation": "The Opening",
        "transliteration": "Al-Fatiha"
    }
}
PreviousLanguagesNextAyahs

Last updated 5 years ago

Was this helpful?