# Quran



The full surah index, and the Arabic text, translation, and recitation of any surah.



## Quran Surah Index

All 114 surahs with their Arabic and Latin names, meaning, ayah count, and place of revelation.

- Method: `GET`
- Path: `/v1/quran/surahs`

**Example request**

```bash
curl https://api.diraz.ae/v1/quran/surahs \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "surahs": [
      {
        "number": 1,
        "name": "الفاتحة",
        "name_latin": "Al-Fatihah",
        "meaning_id": "Pembukaan",
        "ayah_count": 7,
        "revealed_in": "Mekah"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-18T17:05:15.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-19T17:05:15.000Z"
  }
}
```

## Quran Surah Text and Recitation

One surah in Arabic with transliteration, Indonesian translation, and recitation links from six reciters.

- Method: `GET`
- Path: `/v1/quran/surahs/{surah}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `surah` | path segment | required | Surah number, 1 to 114. |
| `include_audio` | boolean | optional | Set `false` to drop the recitation links and shrink the payload. |

**Example request**

```bash
curl https://api.diraz.ae/v1/quran/surahs/%7Bsurah%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "number": 1,
    "name": "الفاتحة",
    "name_latin": "Al-Fatihah",
    "meaning_id": "Pembukaan",
    "ayah_count": 7,
    "revealed_in": "Mekah",
    "description_id": "Surat Al-Fatihah (Pembukaan) diturunkan di Mekah dan terdiri dari 7 ayat.",
    "audio_full": [
      { "id": "05", "name": "Misyari Rasyid Al-Afasy", "url": "https://cdn.equran.id/audio-full/..." }
    ],
    "ayahs": [
      {
        "number": 1,
        "arabic": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
        "latin": "Bismillāhir-raḥmānir-raḥīm(i).",
        "translation_id": "Dengan nama Allah Yang Maha Pengasih lagi Maha Penyayang.",
        "audio": [
          { "id": "05", "name": "Misyari Rasyid Al-Afasy", "url": "https://cdn.equran.id/audio-partial/..." }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-18T17:05:15.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-19T17:05:15.000Z"
  }
}
```