# Al-Qur'an Kemenag — Zapi reference

> Official Indonesian Ministry of Religious Affairs Qur'an: 114 surah, 6,236 ayah with Arabic, kitabah, transliteration, Indonesian translation and footnotes, plus the full Kemenag tafsir (wajiz, tahlili, kosakata, munasabah, sabab nuzul).

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/indonesia/quran-kemenag
- Endpoint catalog: https://zpi.web.id/category/indonesia
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Al-Qur'an Kemenag

**Category:** indonesia · **Slug:** `quran-kemenag`
**Detail page:** https://zpi.web.id/api/indonesia/quran-kemenag

Official Indonesian Ministry of Religious Affairs Qur'an: 114 surah, 6,236 ayah with Arabic, kitabah, transliteration, Indonesian translation and footnotes, plus the full Kemenag tafsir (wajiz, tahlili, kosakata, munasabah, sabab nuzul).

**Tags:** quran, islam, kemenag, tafsir, indonesia

### Surah List

All 114 surah with name, ayah count, revelation place and starting mushaf page.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `keyword` | string | query | no | Filter by surah name or translation |
| `revelation` | enum(all|makkiyah|madaniyah) | query | no | Filter by revelation place. Default all |
| `page` | number | query | no | Page number (starts at 1). Default 1 |
| `count` | number | query | no | Items per page. Default 114, max 114 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list?keyword=baqarah&revelation=all&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list?keyword=baqarah&revelation=all&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list?keyword=baqarah&revelation=all&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 10,
  "items": [
    {
      "name": "Al-Fātiḥah",
      "surah": 1,
      "ayahCount": 7,
      "startPage": 1,
      "nameArabic": "الفاتحة",
      "revelation": "Makkiyah",
      "translation": "Pembuka",
      "transliteration": "Al-Fatihah"
    },
    {
      "name": "Al-Baqarah",
      "surah": 2,
      "ayahCount": 286,
      "startPage": 2,
      "nameArabic": "البقرة",
      "revelation": "Madaniyah",
      "translation": "Sapi",
      "transliteration": "Al-Baqarah"
    },
    {
      "name": "Āli ‘Imrān",
      "surah": 3,
      "ayahCount": 200,
      "startPage": 50,
      "nameArabic": "اٰل عمرٰن",
      "revelation": "Madaniyah",
      "translation": "Keluarga Imran",
      "transliteration": "Ali ‘Imran"
    },
    {
      "name": "An-Nisā'",
      "surah": 4,
      "ayahCount": 176,
      "startPage": 77,
      "nameArabic": "النّساۤء",
      "revelation": "Madaniyah",
      "translation": "Perempuan",
      "transliteration": "An-Nisa'"
    },
    {
      "name": "Al-Mā'idah",
      "surah": 5,
      "ayahCount": 120,
      "startPage": 106,
      "nameArabic": "الماۤئدة",
      "revelation": "Madaniyah",
      "translation": "Hidangan",
      "transliteration": "Al-Ma'idah"
    },
    {
      "name": "Al-An‘ām",
      "surah": 6,
      "ayahCount": 165,
      "startPage": 128,
      "nameArabic": "الانعام",
      "revelation": "Makkiyah",
      "translation": "Binatang Ternak",
      "transliteration": "Al-An‘am"
    },
    {
      "name": "Al-A‘rāf",
      "surah": 7,
      "ayahCount": 206,
      "startPage": 151,
      "nameArabic": "الاعراف",
      "revelation": "Makkiyah",
      "translation": "Tempat Tertinggi",
      "transliteration": "Al-A‘raf"
    },
    {
      "name": "Al-Anfāl",
      "surah": 8,
      "ayahCount": 75,
      "startPage": 177,
      "nameArabic": "الانفال",
      "revelation": "Madaniyah",
      "translation": "Rampasan Perang",
      "transliteration": "Al-Anfal"
    }
  ],
  "total": 114,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10,
  "revelation": "all"
}
```

---

### Surah Detail

One surah's metadata by number.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-detail`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-detail?surah=2" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-detail?surah=2", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-detail?surah=2",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "name": "Al-Baqarah",
  "surah": 2,
  "provider": "quran-kemenag",
  "ayahCount": 286,
  "startPage": 2,
  "nameArabic": "البقرة",
  "revelation": "Madaniyah",
  "translation": "Sapi",
  "transliteration": "Al-Baqarah"
}
```

---

### Ayah List

Paged ayah of one surah, full text and position.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-list`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `page` | number | query | no | Page number (starts at 1). Default 1 |
| `count` | number | query | no | Items per page. Default 50, max 300 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-list?surah=2&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-list?surah=2&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-list?surah=2&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 10,
  "items": [
    {
      "juz": 22,
      "ayah": 1,
      "latin": "Yā sīn.",
      "surah": 36,
      "words": [],
      "arabic": "يٰسۤ ۚ",
      "ayahId": 3706,
      "manzil": 5,
      "kitabah": "يٰسۡ ۚ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "Yā Sīn. "
    },
    {
      "juz": 22,
      "ayah": 2,
      "latin": "Wal-qur'ānil-ḥakīm(i).",
      "surah": 36,
      "words": [],
      "arabic": "وَالْقُرْاٰنِ الْحَكِيْمِۙ ",
      "ayahId": 3707,
      "manzil": 5,
      "kitabah": "وَالْقُرْاٰنِ الْحَكِيْمِۙ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "Demi Al-Qur’an yang penuh hikmah,"
    },
    {
      "juz": 22,
      "ayah": 3,
      "latin": "Innaka laminal-mursalīn(a).",
      "surah": 36,
      "words": [],
      "arabic": "اِنَّكَ لَمِنَ الْمُرْسَلِيْنَۙ ",
      "ayahId": 3708,
      "manzil": 5,
      "kitabah": "اِنَّكَ لَمِنَ الْمُرْسَلِيْنَۙ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "sesungguhnya engkau (Nabi Muhammad) benar-benar salah seorang dari rasul-rasul"
    },
    {
      "juz": 22,
      "ayah": 4,
      "latin": "‘Alā ṣirāṭim mustaqīm(in).",
      "surah": 36,
      "words": [],
      "arabic": "عَلٰى صِرَاطٍ مُّسْتَقِيْمٍۗ ",
      "ayahId": 3709,
      "manzil": 5,
      "kitabah": "عَلٰى صِرَاطٍ مُّسْتَقِيْمٍۗ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "(yang berada) di atas jalan yang lurus,"
    },
    {
      "juz": 22,
      "ayah": 5,
      "latin": "Tanzīlal-‘azīzir-raḥīm(i).",
      "surah": 36,
      "words": [],
      "arabic": "تَنْزِيْلَ الْعَزِيْزِ الرَّحِيْمِۙ ",
      "ayahId": 3710,
      "manzil": 5,
      "kitabah": "تَنْزِيْلَ الْعَزِيْزِ الرَّحِيْمِۙ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "(sebagai wahyu) yang diturunkan oleh (Allah) Yang Maha Perkasa lagi Maha Penyayang,"
    },
    {
      "juz": 22,
      "ayah": 6,
      "latin": "Litunżira qaumam mā unżira ābā'uhum fahum gāfilūn(a).",
      "surah": 36,
      "words": [],
      "arabic": "لِتُنْذِرَ قَوْمًا مَّآ اُنْذِرَ اٰبَاۤؤُهُمْ فَهُمْ غٰفِلُوْنَ ",
      "ayahId": 3711,
      "manzil": 5,
      "kitabah": "لِتُنْذِرَ قَوْمًا مَّآ اُنْذِرَ اٰبَاۤؤُهُمْ فَهُمْ غٰفِلُوْنَ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "agar engkau (Nabi Muhammad) memberi peringatan kepada suatu kaum yang nenek moyang mereka belum pernah diberi peringatan, sehingga mereka lalai."
    },
    {
      "juz": 22,
      "ayah": 7,
      "latin": "Laqad ḥaqqal-qaulu ‘alā akṡarihim fahum lā yu'minūn(a).",
      "surah": 36,
      "words": [],
      "arabic": "لَقَدْ حَقَّ الْقَوْلُ عَلٰٓى اَكْثَرِهِمْ فَهُمْ لَا يُؤْمِنُوْنَ ",
      "ayahId": 3712,
      "manzil": 5,
      "kitabah": "لَقَدْ حَقَّ الْقَوْلُ عَلٰٓى اَكْثَرِهِمْ فَهُمْ لَا يُؤْمِنُوْنَ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "Sungguh, benar-benar berlaku perkataan (ketetapan takdir) terhadap kebanyakan mereka, maka mereka tidak akan beriman."
    },
    {
      "juz": 22,
      "ayah": 8,
      "latin": "Innā ja‘alnā fī a‘nāqihim aglālan fa hiya ilal-ażqāni fahum muqmaḥūn(a).",
      "surah": 36,
      "words": [],
      "arabic": "اِنَّا جَعَلْنَا فِيْٓ اَعْنَاقِهِمْ اَغْلٰلًا فَهِيَ اِلَى الْاَذْقَانِ فَهُمْ مُّقْمَحُوْنَ ",
      "ayahId": 3713,
      "manzil": 5,
      "kitabah": "اِنَّا جَعَلْنَا فِيْٓ اَعْنَاقِهِمْ اَغْلٰلًا فَهِيَ اِلَى الْاَذْقَانِ فَهُمْ مُّقْمَحُوْنَ ",
      "footnotes": null,
      "surahName": "Yāsīn",
      "updatedAt": null,
      "mushafPage": 440,
      "quarterHizb": 44.75,
      "translation": "Sesungguhnya Kami telah memasang belenggu di leher mereka, lalu (tangan mereka yang terbelenggu diangkat) ke dagu, karena itu mereka tertengadah."
    }
  ],
  "surah": 36,
  "total": 83,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10,
  "surahName": "Yāsīn"
}
```

---

### Ayah Detail

One ayah: Arabic, kitabah, transliteration, translation, footnotes and position.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-detail`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-detail?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-detail?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-detail?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "juz": 3,
  "ayah": 255,
  "latin": "Allāhu lā ilāha illā huw(a), al-ḥayyul-qayyūm(u), lā ta'khużuhū sinatuw wa lā naum(un), lahū mā fis-samāwāti wa mā fil-arḍ(i), man żal-lażī yasyfa‘u ‘indahū illā bi'iżnih(ī), ya‘lamu mā baina aidīhim wa mā khalfahum, wa lā yuḥīṭūna bisyai'im min ‘ilmihī illā bimā syā'(a), wasi‘a kursiyyuhus-samāwāti wal-arḍ(a), wa lā ya'ūduhū ḥifẓuhumā, wa huwal-‘aliyyul-‘aẓīm(u).  ",
  "surah": 2,
  "words": [],
  "arabic": "اَللّٰهُ لَآ اِلٰهَ اِلَّا هُوَۚ اَلْحَيُّ الْقَيُّوْمُ ەۚ لَا تَأْخُذُهٗ سِنَةٌ وَّلَا نَوْمٌۗ  لَهٗ مَا فِى السَّمٰوٰتِ وَمَا فِى الْاَرْضِۗ مَنْ ذَا الَّذِيْ يَشْفَعُ عِنْدَهٗٓ اِلَّا بِاِذْنِهٖۗ يَعْلَمُ مَا بَيْنَ اَيْدِيْهِمْ وَمَا خَلْفَهُمْۚ وَلَا يُحِيْطُوْنَ بِشَيْءٍ مِّنْ عِلْمِهٖٓ اِلَّا بِمَا شَاۤءَۚ وَسِعَ كُرْسِيُّهُ السَّمٰوٰتِ وَالْاَرْضَۚ وَلَا يَـُٔوْدُهٗ حِفْظُهُمَاۚ وَهُوَ الْعَلِيُّ الْعَظِيْمُ",
  "ayahId": 262,
  "manzil": 1,
  "kitabah": "اَللّٰهُ لَآ اِلٰهَ اِلَّا هُوَۚ اَلْحَيُّ الْقَيُّوْمُ ەۚ لَا تَأْخُذُهٗ سِنَةٌ وَّلَا نَوْمٌۗ  لَهٗ مَا فِى السَّمٰوٰتِ وَمَا فِى الْاَرْضِۗ مَنْ ذَا الَّذِيْ يَشْفَعُ عِنْدَهٗٓ اِلَّا بِاِذْنِهٖۗ يَعْلَمُ مَا بَيْنَ اَيْدِيْهِمْ وَمَا خَلْفَهُمْۚ وَلَا يُحِيْطُوْنَ بِشَيْءٍ مِّنْ عِلْمِهٖٓ اِلَّا بِمَا شَاۤءَۚ وَسِعَ كُرْسِيُّهُ السَّمٰوٰتِ وَالْاَرْضَۚ وَلَا يَـُٔوْدُهٗ حِفْظُهُمَاۚ وَهُوَ الْعَلِيُّ الْعَظِيْمُ",
  "provider": "quran-kemenag",
  "footnotes": null,
  "surahName": "Al-Baqarah",
  "updatedAt": null,
  "mushafPage": 42,
  "quarterHizb": 5,
  "translation": "Allah, tidak ada tuhan selain Dia, Yang Maha Hidup lagi terus-menerus mengurus (makhluk-Nya). Dia tidak dilanda oleh kantuk dan tidak (pula) oleh tidur. Milik-Nyalah apa yang ada di langit dan apa yang ada di bumi. Tidak ada yang dapat memberi syafaat di sisi-Nya tanpa izin-Nya. Dia mengetahui apa yang ada di hadapan mereka dan apa yang ada di belakang mereka. Mereka tidak mengetahui sesuatu apa pun dari ilmu-Nya, kecuali apa yang Dia kehendaki. Kursi-Nya (ilmu dan kekuasaan-Nya) meliputi langit dan bumi. Dia tidak merasa berat memelihara keduanya. Dialah yang Maha Tinggi lagi Maha Agung."
}
```

---

### Ayah by Juz

Paged ayah of one juz (1-30).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-juz`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `juz` | number | query | yes | Juz number, 1-30 |
| `page` | number | query | no | Page number (starts at 1). Default 1 |
| `count` | number | query | no | Items per page. Default 50, max 300 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-juz?juz=30&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-juz?juz=30&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-juz?juz=30&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "juz": 30,
  "page": 1,
  "count": 10,
  "items": [
    {
      "juz": 30,
      "ayah": 1,
      "latin": "‘Amma yatasā'alūn(a).",
      "surah": 78,
      "words": [
        "عَمَّ",
        "يَتَسَاۤءَلُوْنَۚ"
      ],
      "arabic": "عَمَّ يَتَسَاۤءَلُوْنَۚ ",
      "ayahId": 5673,
      "manzil": 7,
      "kitabah": "عَمَّ يَتَسَاۤءَلُوْنَۚ ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Tentang apakah mereka saling bertanya?"
    },
    {
      "juz": 30,
      "ayah": 2,
      "latin": "‘Anin naba'il-‘aẓīm(i).",
      "surah": 78,
      "words": [
        "عَنِ",
        "النَّبَاِ",
        "الْعَظِيْمِۙ"
      ],
      "arabic": "عَنِ النَّبَاِ الْعَظِيْمِۙ ",
      "ayahId": 5674,
      "manzil": 7,
      "kitabah": "عَنِ النَّبَاِ الْعَظِيْمِۙ ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Tentang berita yang besar (hari Kebangkitan)"
    },
    {
      "juz": 30,
      "ayah": 3,
      "latin": "Allażī hum fīhi mukhtalifūn(a).",
      "surah": 78,
      "words": [
        "الَّذِيْ",
        "هُمْ",
        "فِيْهِ",
        "مُخْتَلِفُوْنَۗ"
      ],
      "arabic": "الَّذِيْ هُمْ فِيْهِ مُخْتَلِفُوْنَۗ ",
      "ayahId": 5675,
      "manzil": 7,
      "kitabah": "الَّذِيْ هُمْ فِيْهِ مُخْتَلِفُوْنَۗ ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "yang dalam hal itu mereka berselisih."
    },
    {
      "juz": 30,
      "ayah": 4,
      "latin": "Kallā saya‘lamūn(a).",
      "surah": 78,
      "words": [
        "كَلَّا",
        "سَيَعْلَمُوْنَۙ"
      ],
      "arabic": "كَلَّا سَيَعْلَمُوْنَۙ ",
      "ayahId": 5676,
      "manzil": 7,
      "kitabah": "كَلَّا سَيَعْلَمُوْنَۙ ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Sekali-kali tidak! Kelak mereka akan mengetahui."
    },
    {
      "juz": 30,
      "ayah": 5,
      "latin": "Ṡumma kallā saya‘lamūn(a).",
      "surah": 78,
      "words": [
        "ثُمَّ",
        "كَلَّا",
        "سَيَعْلَمُوْنَ"
      ],
      "arabic": "ثُمَّ كَلَّا سَيَعْلَمُوْنَ",
      "ayahId": 5677,
      "manzil": 7,
      "kitabah": "ثُمَّ كَلَّا سَيَعْلَمُوْنَ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Sekali lagi, tidak! Kelak mereka akan mengetahui. "
    },
    {
      "juz": 30,
      "ayah": 6,
      "latin": "Alam naj‘alil-arḍa mihādā(n).",
      "surah": 78,
      "words": [
        "اَلَمْ",
        "نَجْعَلِ",
        "الْاَرْضَ",
        "مِهٰدًاۙ"
      ],
      "arabic": "اَلَمْ نَجْعَلِ الْاَرْضَ مِهٰدًاۙ",
      "ayahId": 5678,
      "manzil": 7,
      "kitabah": "اَلَمْ نَجْعَلِ الْاَرْضَ مِهٰدًاۙ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Bukankah Kami telah menjadikan bumi sebagai hamparan "
    },
    {
      "juz": 30,
      "ayah": 7,
      "latin": "Wal-jibāla autādā(n).",
      "surah": 78,
      "words": [
        "وَّالْجِبَالَ",
        "اَوْتَادًاۖ"
      ],
      "arabic": "وَّالْجِبَالَ اَوْتَادًاۖ",
      "ayahId": 5679,
      "manzil": 7,
      "kitabah": "وَّالْجِبَالَ اَوْتَادًاۖ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "dan gunung-gunung sebagai pasak?"
    },
    {
      "juz": 30,
      "ayah": 8,
      "latin": "Wa khalaqnākum azwājā(n).",
      "surah": 78,
      "words": [
        "وَّخَلَقْنٰكُمْ",
        "اَزْوَاجًاۙ"
      ],
      "arabic": "وَّخَلَقْنٰكُمْ اَزْوَاجًاۙ ",
      "ayahId": 5680,
      "manzil": 7,
      "kitabah": "وَّخَلَقْنٰكُمْ اَزْوَاجًاۙ ",
      "footnotes": null,
      "surahName": "An-Naba'",
      "updatedAt": null,
      "mushafPage": 582,
      "quarterHizb": 59,
      "translation": "Kami menciptakan kamu berpasang-pasangan."
    }
  ],
  "total": null,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10
}
```

---

### Ayah by Mushaf Page

Every ayah printed on one standard mushaf page (1-604).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-page`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `mushafPage` | number | query | yes | Mushaf page number, 1-604 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-page?mushafPage=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-page?mushafPage=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-page?mushafPage=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 7,
  "items": [
    {
      "juz": 1,
      "ayah": 1,
      "latin": "Bismillāhir-raḥmānir-raḥīm(i). ",
      "surah": 1,
      "words": [
        "بِسْمِ",
        "اللّٰهِ",
        "الرَّحْمٰنِ",
        "الرَّحِيْمِ"
      ],
      "arabic": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
      "ayahId": 1,
      "manzil": 1,
      "kitabah": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
      "footnotes": null,
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:40:19.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Dengan nama Allah Yang Maha Pengasih lagi Maha Penyayang."
    },
    {
      "juz": 1,
      "ayah": 2,
      "latin": "Al-ḥamdu lillāhi rabbil-‘ālamīn(a). ",
      "surah": 1,
      "words": [
        "اَلْحَمْدُ",
        "لِلّٰهِ",
        "رَبِّ",
        "الْعٰلَمِيْنَۙ"
      ],
      "arabic": "اَلْحَمْدُ لِلّٰهِ رَبِّ الْعٰلَمِيْنَۙ",
      "ayahId": 2,
      "manzil": 1,
      "kitabah": "اَلْحَمْدُ لِلّٰهِ رَبِّ الْعٰلَمِيْنَۙ",
      "footnotes": "1) Allah Swt. disebut rabb (Tuhan) seluruh alam karena Dialah yang telah menciptakan, memelihara, mendidik, mengatur, mengurus, memberi rezeki, dan sebagainya kepada semua makhluk-Nya. ",
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:41:27.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Segala puji bagi Allah, Tuhan1) semesta alam"
    },
    {
      "juz": 1,
      "ayah": 3,
      "latin": "Ar-raḥmānir-raḥīm(i). ",
      "surah": 1,
      "words": [
        "الرَّحْمٰنِ",
        "الرَّحِيْمِۙ"
      ],
      "arabic": "الرَّحْمٰنِ الرَّحِيْمِۙ",
      "ayahId": 3,
      "manzil": 1,
      "kitabah": "الرَّحْمٰنِ الرَّحِيْمِۙ",
      "footnotes": null,
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:41:39.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Yang Maha Pengasih lagi Maha Penyayang,"
    },
    {
      "juz": 1,
      "ayah": 4,
      "latin": "Māliki yaumid-dīn(i). ",
      "surah": 1,
      "words": [
        "مٰلِكِ",
        "يَوْمِ",
        "الدِّيْنِۗ"
      ],
      "arabic": "مٰلِكِ يَوْمِ الدِّيْنِۗ",
      "ayahId": 4,
      "manzil": 1,
      "kitabah": "مٰلِكِ يَوْمِ الدِّيْنِۗ",
      "footnotes": "2) Yaumid-dīn (hari Pembalasan) adalah hari ketika kelak manusia menerima balasan atas amal-amalnya yang baik dan yang buruk. Hari itu disebut juga yaumul-qiyāmah (hari Kiamat), yaumul-ḥisāb (hari Penghitungan), dan sebagainya.",
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:41:53.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Pemilik hari Pembalasan.2)"
    },
    {
      "juz": 1,
      "ayah": 5,
      "latin": "Iyyāka na‘budu wa iyyāka nasta‘īn(u), ",
      "surah": 1,
      "words": [
        "اِيَّاكَ",
        "نَعْبُدُ",
        "وَاِيَّاكَ",
        "نَسْتَعِيْنُۗ"
      ],
      "arabic": "اِيَّاكَ نَعْبُدُ وَاِيَّاكَ نَسْتَعِيْنُۗ",
      "ayahId": 5,
      "manzil": 1,
      "kitabah": "اِيَّاكَ نَعْبُدُ وَاِيَّاكَ نَسْتَعِيْنُۗ",
      "footnotes": null,
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:42:03.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Hanya kepada Engkaulah kami menyembah dan hanya kepada Engkaulah kami memohon pertolongan."
    },
    {
      "juz": 1,
      "ayah": 6,
      "latin": "Ihdinaṣ-ṣirāṭal-mustaqīm(a). ",
      "surah": 1,
      "words": [
        "اِهْدِنَا",
        "الصِّرَاطَ",
        "الْمُسْتَقِيْمَۙ"
      ],
      "arabic": "اِهْدِنَا الصِّرَاطَ الْمُسْتَقِيْمَۙ",
      "ayahId": 6,
      "manzil": 1,
      "kitabah": "اِهْدِنَا الصِّرَاطَ الْمُسْتَقِيْمَۙ",
      "footnotes": "3) Jalan yang lurus adalah jalan hidup yang benar dan sesuai dengan ajaran Islam yang terkandung dalam Al-Qur’an dan hadis.",
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:42:14.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Bimbinglah kami ke jalan yang lurus,3)"
    },
    {
      "juz": 1,
      "ayah": 7,
      "latin": "Ṣirāṭal-lażīna an‘amta ‘alaihim, gairil-magḍūbi ‘alaihim wa laḍ-ḍāllīn(a). ",
      "surah": 1,
      "words": [
        "صِرَاطَ",
        "الَّذِيْنَ",
        "اَنْعَمْتَ",
        "عَلَيْهِمْ",
        "ەۙ",
        "غَيْرِ",
        "الْمَغْضُوْبِ",
        "عَلَيْهِمْ"
      ],
      "arabic": "صِرَاطَ الَّذِيْنَ اَنْعَمْتَ عَلَيْهِمْ ەۙ غَيْرِ الْمَغْضُوْبِ عَلَيْهِمْ وَلَا الضَّاۤلِّيْنَ ࣖ",
      "ayahId": 7,
      "manzil": 1,
      "kitabah": "صِرَاطَ الَّذِيْنَ اَنْعَمْتَ عَلَيْهِمْ ەۙ غَيْرِ الْمَغْضُوْبِ عَلَيْهِمْ وَلَا الضَّاۤلِّيْنَ ࣖ",
      "footnotes": null,
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:42:28.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "(yaitu) jalan orang-orang yang telah Engkau beri nikmat, bukan (jalan) mereka yang dimurkai dan bukan (pula jalan) orang-orang yang sesat."
    }
  ],
  "provider": "quran-kemenag",
  "mushafPage": 1
}
```

---

### Ayah Word by Word

Per-word breakdown of one ayah.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-words`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-words?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-words?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-words?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ayah": 1,
  "count": 4,
  "items": [
    {
      "arabic": "بِسْمِ",
      "position": 1
    },
    {
      "arabic": "اللّٰهِ",
      "position": 2
    },
    {
      "arabic": "الرَّحْمٰنِ",
      "position": 3
    },
    {
      "arabic": "الرَّحِيْمِ",
      "position": 4
    }
  ],
  "surah": 1,
  "arabic": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
  "ayahId": 1,
  "provider": "quran-kemenag",
  "surahName": "Al-Fātiḥah",
  "translation": "Dengan nama Allah Yang Maha Pengasih lagi Maha Penyayang."
}
```

---

### Tafsir (Full)

Complete Kemenag tafsir for one ayah: wajiz, tahlili, kosakata, sabab nuzul, munasabah, surah intro/outro and conclusion.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-ayah`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-ayah?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-ayah?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-ayah?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ayah": 255,
  "latin": "Allāhu lā ilāha illā huw(a), al-ḥayyul-qayyūm(u), lā ta'khużuhū sinatuw wa lā naum(un), lahū mā fis-samāwāti wa mā fil-arḍ(i), man żal-lażī yasyfa‘u ‘indahū illā bi'iżnih(ī), ya‘lamu mā baina aidīhim wa mā khalfahum, wa lā yuḥīṭūna bisyai'im min ‘ilmihī illā bimā syā'(a), wasi‘a kursiyyuhus-samāwāti wal-arḍ(a), wa lā ya'ūduhū ḥifẓuhumā, wa huwal-‘aliyyul-‘aẓīm(u).  ",
  "surah": 2,
  "wajiz": "Allah; tidak ada tuhan yang pantas disembah dan dipertuhan selain Dia. Yang Mahahidup, kekal, dan memiliki semua makna kehidupan yang sempurna, Yang terus menerus mengurus makhluk-Nya. Tidak seperti manusia, Dia tidak mengantuk dan tidak pula tidur, sebab keduanya adalah sifat kekurangan yang membuat-Nya tidak mampu mengurus makhluk-Nya. Milik-Nya apa yang ada di langit dan apa yang ada di bumi. Dia Yang menciptakan, memelihara, memiliki, dan bertindak terhadap semua itu. Tidak ada yang dapat memberi syafaat pertolongan di sisi-Nya tanpa izin-Nya. Dia demikian perkasa dan kuasa sehingga berbicara di hadapan-Nya pun harus setelah memperolah restu-Nya, bahkan apa yang disampaikan itu harus sesuatu yang benar. Dia mengetahui apa yang di hadapan mereka, yakni apa saja yang sedang dan akan terjadi, dan apa yang di belakang mereka, yakni sesuatu yang telah berlalu. Allah mengetahui apa yang mereka lakukan dan rencanakan, baik yang berkaitan dengan masa kini, masa lampau, atau masa depan. Dan mereka tidak mengetahui sesuatu apa pun tentang ilmu-Nya melainkan apa yang Dia kehendaki untuk mereka ketahui dengan memperlihatkan dan memberitahukannya. Kursi-Nya, yaitu kekuasaan, ilmu, atau kursi tempat kedua kaki Tuhan (yang tidak diketahui hakikatnya kecuali oleh Allah) berpijak, sangat luas, meliputi langit dan bumi. Dan jangan menduga karena kursi-Nya terlalu luas, Dia letih mengurus itu semua. Tidak! Dia tidak merasa berat maupun kesulitan memelihara keduanya, dan Dia Mahatinggi zat dan sifat-sifat-Nya jika dibanding makhluk-makhlukNya, Mahabesar dengan segala keagungan dan kekuasaan-Nya. Inilah Ayat Kursi, ayat teragung dalam Al-Qur'an karena mencakup namanama dan sifat-sifat Allah yang menunjukkan kesempurnaan zat, ilmu, kekuasaan, dan keagungan-Nya. Ayat ini dinamakan Ayat Kursi. Siapa yang membacanya akan memperoleh perlindungan Allah dan tidak akan diganggu setan.",
  "arabic": "اَللّٰهُ لَآ اِلٰهَ اِلَّا هُوَۚ اَلْحَيُّ الْقَيُّوْمُ ەۚ لَا تَأْخُذُهٗ سِنَةٌ وَّلَا نَوْمٌۗ  لَهٗ مَا فِى السَّمٰوٰتِ وَمَا فِى الْاَرْضِۗ مَنْ ذَا الَّذِيْ يَشْفَعُ عِنْدَهٗٓ اِلَّا بِاِذْنِهٖۗ يَعْلَمُ مَا بَيْنَ اَيْدِيْهِمْ وَمَا خَلْفَهُمْۚ وَلَا يُحِيْطُوْنَ بِشَيْءٍ مِّنْ عِلْمِهٖٓ اِلَّا بِمَا شَاۤءَۚ وَسِعَ كُرْسِيُّهُ السَّمٰوٰتِ وَالْاَرْضَۚ وَلَا يَـُٔوْدُهٗ حِفْظُهُمَاۚ وَهُوَ الْعَلِيُّ الْعَظِيْمُ",
  "ayahId": 262,
  "tahlili": "Allah adalah Tuhan Yang Maha Esa, tidak ada tuhan selain Dia, dan hanya Dia yang berhak untuk disembah. Adapun tuhan-tuhan yang lain yang disembah oleh sebagian manusia dengan alasan yang tidak benar, memang banyak jumlahnya. Akan tetapi Tuhan yang sebenarnya hanyalah Allah. Hanya Dialah Yang hidup abadi, yang ada dengan sendiri-Nya, dan Dia pulalah yang selalu mengatur makhluk-Nya tanpa ada kelalaian sedikit pun.\nKemudian ditegaskan lagi bahwa Allah tidak pernah mengantuk. Orang yang berada dalam keadaan mengantuk tentu hilang kesadarannya, sehingga dia tidak akan dapat melakukan pekerjaannya dengan baik, padahal Allah swt senantiasa mengurus dan memelihara makhluk-Nya dengan baik, tidak pernah kehilangan kesadaran atau pun lalai.\nKarena Allah tidak pernah mengantuk, sudah tentu Dia tidak pernah tidur, karena mengantuk adalah permulaan dari proses tidur. Orang yang tidur lebih banyak kehilangan kesadaran daripada orang yang mengantuk.\nSifat Allah yang lain yang disebutkan dalam ayat ini ialah bahwa Dialah yang mempunyai kekuasaan dan yang memiliki apa yang ada di langit dan di bumi. Dialah yang mempunyai kekuatan dan kekuasaan yang tak terbatas, sehingga Dia dapat berbuat apa yang dikehendaki-Nya. Semuanya ada dalam kekuasaan-Nya, sehingga tidak ada satu pun dari makhluk-Nya termasuk para nabi dan para malaikat yang dapat memberikan pertolongan kecuali dengan izin-Nya, apalagi patung-patung yang oleh orang-orang kafir dianggap sebagai penolong mereka.\nYang dimaksud dengan “pertolongan” atau “syafaat” dalam ayat ini ialah pertolongan yang diberikan oleh para malaikat, nabi dan orang-orang saleh kepada umat manusia pada hari kiamat untuk mendapatkan keringanan atau kebebasan dari hukuman Allah. Syafaat itu akan terjadi atas izin Allah. Dalam hadis disebutkan :\nقَالَ النَّبِيُّ صَلَّى اللهُ عَلَيْهِ وَسَلَّمَ : ...فَيَقُوْلُ اللهُ عَزَّ وَجَلَّ: شَفَعَتْ اَلْمَلاَئِكَةُ وَشَفَعَ النَّبِيُّوْنَ وَشَفَعَ الْمُؤْمِنُوْنَ (رواه أحمد ومسلم عن ابي سعيد الخدري)\nNabi Saw bersabda, “…Kemudian Allah berfirman, “Para Malaikat memberikan syafaat, para Nabi memberikan syafaat, dan orang-orang mukmin juga memberikan syafaat. (Riwayat Aḥmad dan Muslim dari Abu Sa‘id al-Khudrī)\nSifat Allah yang lain yang disebutkan dalam ayat ini ialah: bahwa Allah senantiasa mengetahui apa saja yang terjadi di hadapan dan di belakang makhluk-Nya, sedang mereka tidak mengetahui sesuatu pun dari ilmu Allah, melainkan sekadar apa yang dikehendaki-Nya untuk mereka ketahui. Kursi Allah mencakup langit dan bumi. Allah tidak merasa berat sedikit pun dalam memelihara makhluk-Nya yang berada di langit dan di bumi, dan di semua alam ciptaan-Nya. Allah Mahatinggi lagi Mahabesar.\nMereka tidak mengetahui ilmu Allah, kecuali apa yang telah dikehendaki-Nya untuk mereka ketahui. Dengan demikian, yang dapat diketahui oleh manusia hanyalah sekadar apa yang dapat dijangkau oleh pengetahuan yang telah dikaruniakan Allah kepada mereka, dan jumlahnya amat sedikit dibanding dengan ilmu-Nya yang luas. Hal ini ditegaskan Allah dalam firman-Nya:\nوَمَآ اُوْتِيْتُمْ مِّنَ الْعِلْمِ اِلَّا قَلِيْلًا \n“… Sedangkan kamu diberi pengetahuan hanya sedikit.” (al-Isrā’/17:85)",
  "kosakata": "Kosakata: Kursi كُرْسِيٌّ (al-Baqarah/2: 255)\nSecara etimologis, kursi berarti tempat duduk, singgasana atau tahta (ṣād/38: 34). Asal katanya الكرسي artinya tempat berkumpul. Segala sesuatu yang berkumpul disebut kursi. Oleh sebab itu, buku tulis disebut kurrāsah karena tempat berkumpulnya lembaran-lembaran kertas. Kursi dalam ayat ini, oleh sebagian mufasir ditakwil dengan ilmu Allah. Ada pula yang mengartikan kekuasaan-Nya. Menurut Ibnu ‘Abbās dalam riwayat yang sahih, yang dimaksud dengan Kursi adalah tempat dua telapak kaki Allah. Tentu saja dengan pengertian bahwa hal itu tidak sama dengan telapak kaki makhluk-Nya. Ada juga riwayat dari Ibnu ‘Abbās bahwa yang dimaksud dengan Kursi adalah ilmu Allah, tetapi riwayat ini lemah. Dalam ayat ini dijelaskan besar dan luasnya Kursi Allah yang meliputi langit dan bumi. ",
  "provider": "quran-kemenag",
  "surahName": "Al-Baqarah",
  "conclusion": "1.\tHanya Allah sajalah Tuhan bagi semua umat manusia yang wajib diimani, disembah, dipuji dan ditaati, sebab Dialah yang wajibul-wujud, hidup abadi. Dialah Pencipta, Pemelihara dan Pelindung alam ini.\n2.\tAllah tidak mengantuk dan tidak tidur. Dia selalu mengurus makhluk-Nya tanpa lalai sedikit pun. Dia mengetahui apa saja yang terjadi di alam ini.\n3.\tHanya Allah yang menguasai, memiliki dan mengatur serta memelihara langit dan bumi, dan apa-apa yang terdapat pada keduanya. Dia tidak merasa berat memeliharanya.\n4.\tIlmu Allah Mahaluas, meliputi semua makhluk-Nya dan mengetahui segala yang dikerjakan mereka, baik yang tampak maupun yang tidak.",
  "introSurah": "Surah al-Baqarah yang terdiri dari 286 ayat adalah termasuk golongan surah Madaniyah yang diturunkan pada tahun-tahun permulaan periode Nabi Muhammad saw di Medinah. Ia merupakan surah yang terpanjang dan terbanyak ayat-ayatnya di antara surah yang ada di dalam Al-Qur’an. Surah ini dinamai “al-Baqarah” yang berarti “seekor sapi”, karena di dalamnya disebutkan kisah penyembelihan sapi betina yang diperintahkan Allah kepada Bani Israil. Dalam pelaksanaan penyembelihan sapi betina itu tampak dengan jelas sifat dan watak orang-orang Yahudi pada umumnya.\nDinamakan juga fusṭaṭ al-Qur’ān yang berarti “puncak Al-Qur’an” karena surah ini memuat beberapa hukum yang tidak disebut di surah-surah yang lain. Juga dinamakan Alīf Lām Mīm, karena surah ini dimulai dengan huruf-huruf hijaiyah (abjad) alif lām mīm.\nDi antara pokok-pokok isinya ialah:\n1.\tKeimanan: Dakwah Islamiah yang ditujukan kepada umat Islam, Ahli Kitab dan orang-orang musyrik.\n2.\tHukum: Perintah mengerjakan salat, perintah menunaikan zakat, puasa, haji dan umrah, qiṣaṣ, yang halal dan yang haram, bernafkah di jalan Allah, minum arak dan berjudi, cara bergaul dengan anak yatim, prinsip-prinsip ekonomi, larangan memakan riba, utang piutang, nafkah dan yang berhak menerimanya, wasiat kepada dua orang ibu bapak dan kaum kerabat, hukum sumpah, kewajiban menyampaikan amanat, sihir, hukum merusak masjid, hukum mengubah kitab-kitab Allah, haid, idah, talak, khulu‘, ilā, hukum susuan, meminang, mahar, menikahi wanita musyrik dan sebaliknya, hukum perang, dan lain-lain. \n3.\tKisah: Penciptaan Nabi Adam a.s., kisah Nabi Ibrahim a.s., dan kisah Nabi Musa a.s. dengan Bani Israil.\n4.\tLain-lain, seperti: sifat orang yang bertakwa, sifat-sifat orang munafik, sifat-sifat Allah, perumpamaan-perumpamaan, kiblat, dan kebangkitan sesudah mati.",
  "outroSurah": null,
  "sababNuzul": null,
  "themeGroup": "AYAT KURSI",
  "translation": "Allah, tidak ada tuhan selain Dia, Yang Maha Hidup lagi terus-menerus mengurus (makhluk-Nya). Dia tidak dilanda oleh kantuk dan tidak (pula) oleh tidur. Milik-Nyalah apa yang ada di langit dan apa yang ada di bumi. Tidak ada yang dapat memberi syafaat di sisi-Nya tanpa izin-Nya. Dia mengetahui apa yang ada di hadapan mereka dan apa yang ada di belakang mereka. Mereka tidak mengetahui sesuatu apa pun dari ilmu-Nya, kecuali apa yang Dia kehendaki. Kursi-Nya (ilmu dan kekuasaan-Nya) meliputi langit dan bumi. Dia tidak merasa berat memelihara keduanya. Dialah yang Maha Tinggi lagi Maha Agung.",
  "munasabahPrevSurah": "1.\tSurah al-Fātiḥah merupakan pokok-pokok pembahasan yang akan dirinci dalam surah al-Baqarah dan surah-surah sesudahnya.\n2.\tDi bagian akhir surah al-Fātiḥah disebutkan permohonan hamba, agar diberi petunjuk oleh Allah ke jalan yang lurus, sedang surah al-Baqarah dimulai dengan ayat yang menerangkan bahwa Al-Qur’an adalah kitab yang menunjukkan jalan yang dimaksudkan itu.\n3.\tDi akhir surah al-Fātiḥah disebutkan tiga kelompok manusia, yaitu yang diberi nikmat, yang dimurkai Allah dan orang yang sesat, sedangkan di awal surah al-Baqarah juga disebutkan tiga kelompok manusia, yaitu orang yang bertakwa, orang kafir, dan orang munafik.",
  "munasabahPrevTheme": "Pada ayat yang lalu, Allah swt telah memerintahkan kepada orang-orang mukmin agar mereka mengeluarkan zakat atau pun sedekah dari harta benda mereka. Dia memperingatkan orang-orang yang tidak mau mengeluarkan zakat dan menyebut mereka sebagai “orang-orang yang kafir” terhadap nikmat dan karunia-Nya. Dalam ayat ini, Allah swt menyebutkan sebagian dari sifat-sifat-Nya yang maha tinggi."
}
```

---

### Tafsir Wajiz

Short-form Kemenag tafsir for one ayah.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-wajiz`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-wajiz?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-wajiz?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-wajiz?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ayah": 255,
  "latin": "Allāhu lā ilāha illā huw(a), al-ḥayyul-qayyūm(u), lā ta'khużuhū sinatuw wa lā naum(un), lahū mā fis-samāwāti wa mā fil-arḍ(i), man żal-lażī yasyfa‘u ‘indahū illā bi'iżnih(ī), ya‘lamu mā baina aidīhim wa mā khalfahum, wa lā yuḥīṭūna bisyai'im min ‘ilmihī illā bimā syā'(a), wasi‘a kursiyyuhus-samāwāti wal-arḍ(a), wa lā ya'ūduhū ḥifẓuhumā, wa huwal-‘aliyyul-‘aẓīm(u).  ",
  "surah": 2,
  "wajiz": "Allah; tidak ada tuhan yang pantas disembah dan dipertuhan selain Dia. Yang Mahahidup, kekal, dan memiliki semua makna kehidupan yang sempurna, Yang terus menerus mengurus makhluk-Nya. Tidak seperti manusia, Dia tidak mengantuk dan tidak pula tidur, sebab keduanya adalah sifat kekurangan yang membuat-Nya tidak mampu mengurus makhluk-Nya. Milik-Nya apa yang ada di langit dan apa yang ada di bumi. Dia Yang menciptakan, memelihara, memiliki, dan bertindak terhadap semua itu. Tidak ada yang dapat memberi syafaat pertolongan di sisi-Nya tanpa izin-Nya. Dia demikian perkasa dan kuasa sehingga berbicara di hadapan-Nya pun harus setelah memperolah restu-Nya, bahkan apa yang disampaikan itu harus sesuatu yang benar. Dia mengetahui apa yang di hadapan mereka, yakni apa saja yang sedang dan akan terjadi, dan apa yang di belakang mereka, yakni sesuatu yang telah berlalu. Allah mengetahui apa yang mereka lakukan dan rencanakan, baik yang berkaitan dengan masa kini, masa lampau, atau masa depan. Dan mereka tidak mengetahui sesuatu apa pun tentang ilmu-Nya melainkan apa yang Dia kehendaki untuk mereka ketahui dengan memperlihatkan dan memberitahukannya. Kursi-Nya, yaitu kekuasaan, ilmu, atau kursi tempat kedua kaki Tuhan (yang tidak diketahui hakikatnya kecuali oleh Allah) berpijak, sangat luas, meliputi langit dan bumi. Dan jangan menduga karena kursi-Nya terlalu luas, Dia letih mengurus itu semua. Tidak! Dia tidak merasa berat maupun kesulitan memelihara keduanya, dan Dia Mahatinggi zat dan sifat-sifat-Nya jika dibanding makhluk-makhlukNya, Mahabesar dengan segala keagungan dan kekuasaan-Nya. Inilah Ayat Kursi, ayat teragung dalam Al-Qur'an karena mencakup namanama dan sifat-sifat Allah yang menunjukkan kesempurnaan zat, ilmu, kekuasaan, dan keagungan-Nya. Ayat ini dinamakan Ayat Kursi. Siapa yang membacanya akan memperoleh perlindungan Allah dan tidak akan diganggu setan.",
  "arabic": "اَللّٰهُ لَآ اِلٰهَ اِلَّا هُوَۚ اَلْحَيُّ الْقَيُّوْمُ ەۚ لَا تَأْخُذُهٗ سِنَةٌ وَّلَا نَوْمٌۗ  لَهٗ مَا فِى السَّمٰوٰتِ وَمَا فِى الْاَرْضِۗ مَنْ ذَا الَّذِيْ يَشْفَعُ عِنْدَهٗٓ اِلَّا بِاِذْنِهٖۗ يَعْلَمُ مَا بَيْنَ اَيْدِيْهِمْ وَمَا خَلْفَهُمْۚ وَلَا يُحِيْطُوْنَ بِشَيْءٍ مِّنْ عِلْمِهٖٓ اِلَّا بِمَا شَاۤءَۚ وَسِعَ كُرْسِيُّهُ السَّمٰوٰتِ وَالْاَرْضَۚ وَلَا يَـُٔوْدُهٗ حِفْظُهُمَاۚ وَهُوَ الْعَلِيُّ الْعَظِيْمُ",
  "ayahId": 262,
  "provider": "quran-kemenag",
  "surahName": "Al-Baqarah",
  "translation": "Allah, tidak ada tuhan selain Dia, Yang Maha Hidup lagi terus-menerus mengurus (makhluk-Nya). Dia tidak dilanda oleh kantuk dan tidak (pula) oleh tidur. Milik-Nyalah apa yang ada di langit dan apa yang ada di bumi. Tidak ada yang dapat memberi syafaat di sisi-Nya tanpa izin-Nya. Dia mengetahui apa yang ada di hadapan mereka dan apa yang ada di belakang mereka. Mereka tidak mengetahui sesuatu apa pun dari ilmu-Nya, kecuali apa yang Dia kehendaki. Kursi-Nya (ilmu dan kekuasaan-Nya) meliputi langit dan bumi. Dia tidak merasa berat memelihara keduanya. Dialah yang Maha Tinggi lagi Maha Agung."
}
```

---

### Tafsir Tahlili

Long-form analytical Kemenag tafsir for one ayah.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-tahlili`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-tahlili?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-tahlili?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-tahlili?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ayah": 255,
  "latin": "Allāhu lā ilāha illā huw(a), al-ḥayyul-qayyūm(u), lā ta'khużuhū sinatuw wa lā naum(un), lahū mā fis-samāwāti wa mā fil-arḍ(i), man żal-lażī yasyfa‘u ‘indahū illā bi'iżnih(ī), ya‘lamu mā baina aidīhim wa mā khalfahum, wa lā yuḥīṭūna bisyai'im min ‘ilmihī illā bimā syā'(a), wasi‘a kursiyyuhus-samāwāti wal-arḍ(a), wa lā ya'ūduhū ḥifẓuhumā, wa huwal-‘aliyyul-‘aẓīm(u).  ",
  "surah": 2,
  "arabic": "اَللّٰهُ لَآ اِلٰهَ اِلَّا هُوَۚ اَلْحَيُّ الْقَيُّوْمُ ەۚ لَا تَأْخُذُهٗ سِنَةٌ وَّلَا نَوْمٌۗ  لَهٗ مَا فِى السَّمٰوٰتِ وَمَا فِى الْاَرْضِۗ مَنْ ذَا الَّذِيْ يَشْفَعُ عِنْدَهٗٓ اِلَّا بِاِذْنِهٖۗ يَعْلَمُ مَا بَيْنَ اَيْدِيْهِمْ وَمَا خَلْفَهُمْۚ وَلَا يُحِيْطُوْنَ بِشَيْءٍ مِّنْ عِلْمِهٖٓ اِلَّا بِمَا شَاۤءَۚ وَسِعَ كُرْسِيُّهُ السَّمٰوٰتِ وَالْاَرْضَۚ وَلَا يَـُٔوْدُهٗ حِفْظُهُمَاۚ وَهُوَ الْعَلِيُّ الْعَظِيْمُ",
  "ayahId": 262,
  "tahlili": "Allah adalah Tuhan Yang Maha Esa, tidak ada tuhan selain Dia, dan hanya Dia yang berhak untuk disembah. Adapun tuhan-tuhan yang lain yang disembah oleh sebagian manusia dengan alasan yang tidak benar, memang banyak jumlahnya. Akan tetapi Tuhan yang sebenarnya hanyalah Allah. Hanya Dialah Yang hidup abadi, yang ada dengan sendiri-Nya, dan Dia pulalah yang selalu mengatur makhluk-Nya tanpa ada kelalaian sedikit pun.\nKemudian ditegaskan lagi bahwa Allah tidak pernah mengantuk. Orang yang berada dalam keadaan mengantuk tentu hilang kesadarannya, sehingga dia tidak akan dapat melakukan pekerjaannya dengan baik, padahal Allah swt senantiasa mengurus dan memelihara makhluk-Nya dengan baik, tidak pernah kehilangan kesadaran atau pun lalai.\nKarena Allah tidak pernah mengantuk, sudah tentu Dia tidak pernah tidur, karena mengantuk adalah permulaan dari proses tidur. Orang yang tidur lebih banyak kehilangan kesadaran daripada orang yang mengantuk.\nSifat Allah yang lain yang disebutkan dalam ayat ini ialah bahwa Dialah yang mempunyai kekuasaan dan yang memiliki apa yang ada di langit dan di bumi. Dialah yang mempunyai kekuatan dan kekuasaan yang tak terbatas, sehingga Dia dapat berbuat apa yang dikehendaki-Nya. Semuanya ada dalam kekuasaan-Nya, sehingga tidak ada satu pun dari makhluk-Nya termasuk para nabi dan para malaikat yang dapat memberikan pertolongan kecuali dengan izin-Nya, apalagi patung-patung yang oleh orang-orang kafir dianggap sebagai penolong mereka.\nYang dimaksud dengan “pertolongan” atau “syafaat” dalam ayat ini ialah pertolongan yang diberikan oleh para malaikat, nabi dan orang-orang saleh kepada umat manusia pada hari kiamat untuk mendapatkan keringanan atau kebebasan dari hukuman Allah. Syafaat itu akan terjadi atas izin Allah. Dalam hadis disebutkan :\nقَالَ النَّبِيُّ صَلَّى اللهُ عَلَيْهِ وَسَلَّمَ : ...فَيَقُوْلُ اللهُ عَزَّ وَجَلَّ: شَفَعَتْ اَلْمَلاَئِكَةُ وَشَفَعَ النَّبِيُّوْنَ وَشَفَعَ الْمُؤْمِنُوْنَ (رواه أحمد ومسلم عن ابي سعيد الخدري)\nNabi Saw bersabda, “…Kemudian Allah berfirman, “Para Malaikat memberikan syafaat, para Nabi memberikan syafaat, dan orang-orang mukmin juga memberikan syafaat. (Riwayat Aḥmad dan Muslim dari Abu Sa‘id al-Khudrī)\nSifat Allah yang lain yang disebutkan dalam ayat ini ialah: bahwa Allah senantiasa mengetahui apa saja yang terjadi di hadapan dan di belakang makhluk-Nya, sedang mereka tidak mengetahui sesuatu pun dari ilmu Allah, melainkan sekadar apa yang dikehendaki-Nya untuk mereka ketahui. Kursi Allah mencakup langit dan bumi. Allah tidak merasa berat sedikit pun dalam memelihara makhluk-Nya yang berada di langit dan di bumi, dan di semua alam ciptaan-Nya. Allah Mahatinggi lagi Mahabesar.\nMereka tidak mengetahui ilmu Allah, kecuali apa yang telah dikehendaki-Nya untuk mereka ketahui. Dengan demikian, yang dapat diketahui oleh manusia hanyalah sekadar apa yang dapat dijangkau oleh pengetahuan yang telah dikaruniakan Allah kepada mereka, dan jumlahnya amat sedikit dibanding dengan ilmu-Nya yang luas. Hal ini ditegaskan Allah dalam firman-Nya:\nوَمَآ اُوْتِيْتُمْ مِّنَ الْعِلْمِ اِلَّا قَلِيْلًا \n“… Sedangkan kamu diberi pengetahuan hanya sedikit.” (al-Isrā’/17:85)",
  "kosakata": "Kosakata: Kursi كُرْسِيٌّ (al-Baqarah/2: 255)\nSecara etimologis, kursi berarti tempat duduk, singgasana atau tahta (ṣād/38: 34). Asal katanya الكرسي artinya tempat berkumpul. Segala sesuatu yang berkumpul disebut kursi. Oleh sebab itu, buku tulis disebut kurrāsah karena tempat berkumpulnya lembaran-lembaran kertas. Kursi dalam ayat ini, oleh sebagian mufasir ditakwil dengan ilmu Allah. Ada pula yang mengartikan kekuasaan-Nya. Menurut Ibnu ‘Abbās dalam riwayat yang sahih, yang dimaksud dengan Kursi adalah tempat dua telapak kaki Allah. Tentu saja dengan pengertian bahwa hal itu tidak sama dengan telapak kaki makhluk-Nya. Ada juga riwayat dari Ibnu ‘Abbās bahwa yang dimaksud dengan Kursi adalah ilmu Allah, tetapi riwayat ini lemah. Dalam ayat ini dijelaskan besar dan luasnya Kursi Allah yang meliputi langit dan bumi. ",
  "provider": "quran-kemenag",
  "surahName": "Al-Baqarah",
  "themeGroup": "AYAT KURSI",
  "translation": "Allah, tidak ada tuhan selain Dia, Yang Maha Hidup lagi terus-menerus mengurus (makhluk-Nya). Dia tidak dilanda oleh kantuk dan tidak (pula) oleh tidur. Milik-Nyalah apa yang ada di langit dan apa yang ada di bumi. Tidak ada yang dapat memberi syafaat di sisi-Nya tanpa izin-Nya. Dia mengetahui apa yang ada di hadapan mereka dan apa yang ada di belakang mereka. Mereka tidak mengetahui sesuatu apa pun dari ilmu-Nya, kecuali apa yang Dia kehendaki. Kursi-Nya (ilmu dan kekuasaan-Nya) meliputi langit dan bumi. Dia tidak merasa berat memelihara keduanya. Dialah yang Maha Tinggi lagi Maha Agung."
}
```

---

### Sabab Nuzul

Occasion of revelation for one ayah, where the source records one.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/sabab-nuzul`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |
| `ayah` | number | query | yes | Ayah number within the surah, 1-286 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/sabab-nuzul?surah=2&ayah=255" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/sabab-nuzul?surah=2&ayah=255", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/sabab-nuzul?surah=2&ayah=255",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ayah": 118,
  "latin": "Yā ayyuhal-lażīna āmanū lā tattakhiżū biṭānatam min dūnikum lā ya'lūnakum khabālā(n), waddū mā ‘anittum, qad badatil-bagḍā'u min afwāhihim, wa mā tukhfī ṣudūruhum akbar(u), qad bayyannā lakumul-āyāti in kuntum ta‘qilūn(a).",
  "surah": 3,
  "arabic": "يٰٓاَيُّهَا الَّذِيْنَ اٰمَنُوْا لَا تَتَّخِذُوْا بِطَانَةً مِّنْ دُوْنِكُمْ لَا يَأْلُوْنَكُمْ خَبَالًاۗ وَدُّوْا مَا عَنِتُّمْۚ قَدْ بَدَتِ الْبَغْضَاۤءُ مِنْ اَفْوَاهِهِمْۖ وَمَا تُخْفِيْ صُدُوْرُهُمْ اَكْبَرُ ۗ قَدْ بَيَّنَّا لَكُمُ الْاٰيٰتِ  اِنْ كُنْتُمْ تَعْقِلُوْنَ",
  "ayahId": 411,
  "provider": "quran-kemenag",
  "surahName": "Āli ‘Imrān",
  "sababNuzul": "Menurut Ibnu Abbas ayat ini diturunkan berhubungan dengan tindakan sebagian kaum Muslimin yang berhubungan erat dengan orang-orang Yahudi Medinah karena bertetangga dan adanya perjanjian damai antara mereka. Bagaimanapun sebab turun ayat ini, namun dapat dipahami bahwa Allah melarang mengambil orang kafir yang telah nyata niat jahatnya terhadap orang mukmin sebagai teman akrab. Mereka adalah orang-orang musyrik, Yahudi, munafik dan lain-lain.",
  "translation": "Wahai orang-orang yang beriman, janganlah kamu mengambil teman kepercayaan dari orang-orang di luar kalangan (agama)-mu (karena) mereka tidak henti-hentinya (mendatangkan) kemudaratan bagimu. Mereka menginginkan apa yang menyusahkanmu. Sungguh, telah nyata kebencian dari mulut mereka dan apa yang mereka sembunyikan dalam hati lebih besar. Sungguh, Kami telah menerangkan kepadamu ayat-ayat (Kami), jika kamu berpikir.",
  "hasSababNuzul": true
}
```

---

### Surah Overview

Surah introduction, closing, theme group and relation to the previous surah.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-overview`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | yes | Surah number, 1-114 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-overview?surah=2" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-overview?surah=2", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-overview?surah=2",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "name": "Al-Baqarah",
  "surah": 2,
  "provider": "quran-kemenag",
  "ayahCount": 286,
  "startPage": 2,
  "conclusion": null,
  "introSurah": "Surah al-Baqarah yang terdiri dari 286 ayat adalah termasuk golongan surah Madaniyah yang diturunkan pada tahun-tahun permulaan periode Nabi Muhammad saw di Medinah. Ia merupakan surah yang terpanjang dan terbanyak ayat-ayatnya di antara surah yang ada di dalam Al-Qur’an. Surah ini dinamai “al-Baqarah” yang berarti “seekor sapi”, karena di dalamnya disebutkan kisah penyembelihan sapi betina yang diperintahkan Allah kepada Bani Israil. Dalam pelaksanaan penyembelihan sapi betina itu tampak dengan jelas sifat dan watak orang-orang Yahudi pada umumnya.\nDinamakan juga fusṭaṭ al-Qur’ān yang berarti “puncak Al-Qur’an” karena surah ini memuat beberapa hukum yang tidak disebut di surah-surah yang lain. Juga dinamakan Alīf Lām Mīm, karena surah ini dimulai dengan huruf-huruf hijaiyah (abjad) alif lām mīm.\nDi antara pokok-pokok isinya ialah:\n1.\tKeimanan: Dakwah Islamiah yang ditujukan kepada umat Islam, Ahli Kitab dan orang-orang musyrik.\n2.\tHukum: Perintah mengerjakan salat, perintah menunaikan zakat, puasa, haji dan umrah, qiṣaṣ, yang halal dan yang haram, bernafkah di jalan Allah, minum arak dan berjudi, cara bergaul dengan anak yatim, prinsip-prinsip ekonomi, larangan memakan riba, utang piutang, nafkah dan yang berhak menerimanya, wasiat kepada dua orang ibu bapak dan kaum kerabat, hukum sumpah, kewajiban menyampaikan amanat, sihir, hukum merusak masjid, hukum mengubah kitab-kitab Allah, haid, idah, talak, khulu‘, ilā, hukum susuan, meminang, mahar, menikahi wanita musyrik dan sebaliknya, hukum perang, dan lain-lain. \n3.\tKisah: Penciptaan Nabi Adam a.s., kisah Nabi Ibrahim a.s., dan kisah Nabi Musa a.s. dengan Bani Israil.\n4.\tLain-lain, seperti: sifat orang yang bertakwa, sifat-sifat orang munafik, sifat-sifat Allah, perumpamaan-perumpamaan, kiblat, dan kebangkitan sesudah mati.",
  "nameArabic": "البقرة",
  "outroSurah": null,
  "revelation": "Madaniyah",
  "themeGroup": "GOLONGAN ORANG YANG BERTAKWA",
  "translation": "Sapi",
  "transliteration": "Al-Baqarah",
  "munasabahPrevSurah": "1.\tSurah al-Fātiḥah merupakan pokok-pokok pembahasan yang akan dirinci dalam surah al-Baqarah dan surah-surah sesudahnya.\n2.\tDi bagian akhir surah al-Fātiḥah disebutkan permohonan hamba, agar diberi petunjuk oleh Allah ke jalan yang lurus, sedang surah al-Baqarah dimulai dengan ayat yang menerangkan bahwa Al-Qur’an adalah kitab yang menunjukkan jalan yang dimaksudkan itu.\n3.\tDi akhir surah al-Fātiḥah disebutkan tiga kelompok manusia, yaitu yang diberi nikmat, yang dimurkai Allah dan orang yang sesat, sedangkan di awal surah al-Baqarah juga disebutkan tiga kelompok manusia, yaitu orang yang bertakwa, orang kafir, dan orang munafik."
}
```

---

### Search Ayah

Search the whole Qur'an by translation, transliteration or Arabic text, optionally scoped to a surah or juz.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/search`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Search term, at least 2 characters |
| `scope` | enum(translation|latin|arabic|all) | query | no | Field to search. Default translation |
| `surah` | number | query | no | Restrict to one surah, 1-114 |
| `juz` | number | query | no | Restrict to one juz, 1-30 |
| `page` | number | query | no | Page number (starts at 1). Default 1 |
| `count` | number | query | no | Items per page. Default 20, max 100 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/search?q=rahmat&scope=translation&surah=2&juz=30&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/search?q=rahmat&scope=translation&surah=2&juz=30&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/search?q=rahmat&scope=translation&surah=2&juz=30&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "juz": null,
  "page": 1,
  "count": 8,
  "items": [
    {
      "juz": 1,
      "ayah": 64,
      "latin": "Ṡumma tawallaitum mim ba‘di żālika falau lā faḍlullāhi ‘alaikum wa raḥmatuhū lakuntum minal-khāsirīn(a).  ",
      "surah": 2,
      "arabic": "ثُمَّ تَوَلَّيْتُمْ مِّنْۢ بَعْدِ ذٰلِكَ  فَلَوْلَا فَضْلُ اللّٰهِ عَلَيْكُمْ وَرَحْمَتُهٗ لَكُنْتُمْ مِّنَ الْخٰسِرِيْنَ",
      "ayahId": 71,
      "surahName": "Al-Baqarah",
      "mushafPage": 10,
      "translation": "Setelah itu, kamu berpaling. Maka, seandainya bukan karena karunia Allah dan rahmat-Nya kepadamu, pasti kamu termasuk orang yang rugi."
    },
    {
      "juz": 1,
      "ayah": 105,
      "latin": "Mā yawaddul-lażīna kafarū min ahlil-kitābi wa lal-musyrikīna ay yunazzila ‘alaikum min khairim mir rabbikum, wallāhu yakhtaṣṣu biraḥmatihī may yasyā'(u), wallāhu żul faḍlil-‘aẓīm(i).  ",
      "surah": 2,
      "arabic": "مَا يَوَدُّ الَّذِيْنَ كَفَرُوْا مِنْ اَهْلِ الْكِتٰبِ وَلَا الْمُشْرِكِيْنَ اَنْ يُّنَزَّلَ عَلَيْكُمْ مِّنْ خَيْرٍ مِّنْ رَّبِّكُمْ ۗ وَاللّٰهُ يَخْتَصُّ بِرَحْمَتِهٖ مَنْ يَّشَاۤءُ ۗ وَاللّٰهُ ذُو الْفَضْلِ الْعَظِيْمِ ",
      "ayahId": 112,
      "surahName": "Al-Baqarah",
      "mushafPage": 16,
      "translation": "Orang-orang kafir dari golongan Ahlulkitab dan orang-orang musyrik tidak menginginkan diturunkannya kepadamu suatu kebaikan dari Tuhanmu. Akan tetapi, secara khusus Allah memberikan rahmat-Nya kepada orang yang Dia kehendaki. Allah pemilik karunia yang besar."
    },
    {
      "juz": 2,
      "ayah": 157,
      "latin": "Ulā'ika ‘alaihim ṣalawātum mir rabbihim wa raḥmah(tun), wa ulā'ika humul-muhtadūn(a). ",
      "surah": 2,
      "arabic": "اُولٰۤىِٕكَ عَلَيْهِمْ صَلَوٰتٌ مِّنْ رَّبِّهِمْ وَرَحْمَةٌ  ۗوَاُولٰۤىِٕكَ هُمُ الْمُهْتَدُوْنَ",
      "ayahId": 164,
      "surahName": "Al-Baqarah",
      "mushafPage": 24,
      "translation": "Mereka itulah yang memperoleh ampunan dan rahmat dari Tuhannya dan mereka itulah orang-orang yang mendapat petunjuk."
    },
    {
      "juz": 2,
      "ayah": 178,
      "latin": "Yā ayyuhal-lażīna āmanū kutiba ‘alaikumul-qiṣāṣu fil-qatlā, al-ḥurru bil-ḥurri wal-‘abdu bil-‘abdi wal-unṡā bil-unṡā, faman ‘ufiya lahū min akhīhi syai'un fattibā‘um bil-ma‘rūfi wa adā'un ilaihi bi iḥsān(in), żālika takhfīfum mir rabbikum wa raḥmah(tun), fa mani‘tadā ba‘da żālika fa lahū ‘ażābun alīm(un).  ",
      "surah": 2,
      "arabic": "يٰٓاَيُّهَا الَّذِيْنَ اٰمَنُوْا كُتِبَ عَلَيْكُمُ الْقِصَاصُ فِى الْقَتْلٰىۗ اَلْحُرُّ بِالْحُرِّ وَالْعَبْدُ بِالْعَبْدِ وَالْاُنْثٰى بِالْاُنْثٰىۗ فَمَنْ عُفِيَ لَهٗ مِنْ اَخِيْهِ شَيْءٌ فَاتِّبَاعٌ ۢبِالْمَعْرُوْفِ وَاَدَاۤءٌ اِلَيْهِ بِاِحْسَانٍ ۗ ذٰلِكَ تَخْفِيْفٌ مِّنْ رَّبِّكُمْ وَرَحْمَةٌ  ۗفَمَنِ اعْتَدٰى بَعْدَ ذٰلِكَ فَلَهٗ عَذَابٌ اَلِيْمٌ ",
      "ayahId": 185,
      "surahName": "Al-Baqarah",
      "mushafPage": 27,
      "translation": "Wahai orang-orang yang beriman, diwajibkan kepadamu (melaksanakan) kisas berkenaan dengan orang-orang yang dibunuh. Orang merdeka dengan orang merdeka, hamba sahaya dengan hamba sahaya, dan perempuan dengan perempuan. Siapa yang memperoleh maaf dari saudaranya hendaklah mengikutinya dengan cara yang patut dan hendaklah menunaikan kepadanya dengan cara yang baik.48) Yang demikian itu adalah keringanan dan rahmat dari Tuhanmu. Siapa yang melampaui batas setelah itu, maka ia akan mendapat azab yang sangat pedih."
    },
    {
      "juz": 2,
      "ayah": 218,
      "latin": "Innal-lażīna āmanū wal-lażīna hājarū wa jāhadū fī sabīlillāh(i), ulā'ika yarjūna raḥmatallāh(i), wallāhu gafūrur raḥīm(un).  ",
      "surah": 2,
      "arabic": "اِنَّ الَّذِيْنَ اٰمَنُوْا وَالَّذِيْنَ هَاجَرُوْا وَجَاهَدُوْا فِيْ سَبِيْلِ اللّٰهِ ۙ اُولٰۤىِٕكَ يَرْجُوْنَ رَحْمَتَ اللّٰهِ ۗوَاللّٰهُ غَفُوْرٌ رَّحِيْمٌ ",
      "ayahId": 225,
      "surahName": "Al-Baqarah",
      "mushafPage": 34,
      "translation": "Sesungguhnya orang-orang yang beriman serta orang-orang yang berhijrah dan berjihad63) di jalan Allah, mereka itu mengharapkan rahmat Allah. Allah Maha Pengampun lagi Maha Penyayang."
    },
    {
      "juz": 3,
      "ayah": 286,
      "latin": "Lā yukallifullāhu nafsan illā wus‘ahā, lahā mā kasabat wa ‘alaihā maktasabat, rabbanā lā tu'ākhiżnā in nasīnā au akhṭa'nā, rabbanā wa lā taḥmil ‘alainā iṣran kamā ḥamaltahū ‘alal-lażīna min qablinā, rabbanā wa lā tuḥammilnā mā lā ṭāqata lanā bih(ī), wa‘fu ‘annā, wagfir lanā, warḥamnā, anta maulānā fanṣurnā ‘alal qaumil-kāfirīn(a).  ",
      "surah": 2,
      "arabic": "لَا يُكَلِّفُ اللّٰهُ نَفْسًا اِلَّا وُسْعَهَا ۗ لَهَا مَا كَسَبَتْ وَعَلَيْهَا مَا اكْتَسَبَتْ ۗ رَبَّنَا لَا تُؤَاخِذْنَآ اِنْ نَّسِيْنَآ اَوْ اَخْطَأْنَا ۚ رَبَّنَا وَلَا تَحْمِلْ عَلَيْنَآ اِصْرًا كَمَا حَمَلْتَهٗ عَلَى الَّذِيْنَ مِنْ قَبْلِنَا ۚ رَبَّنَا وَلَا تُحَمِّلْنَا مَا لَا طَاقَةَ لَنَا بِهٖۚ وَاعْفُ عَنَّاۗ وَاغْفِرْ لَنَاۗ وَارْحَمْنَا ۗ اَنْتَ مَوْلٰىنَا فَانْصُرْنَا عَلَى الْقَوْمِ الْكٰفِرِيْنَ ࣖ",
      "ayahId": 293,
      "surahName": "Al-Baqarah",
      "mushafPage": 49,
      "translation": "Allah tidak membebani seseorang, kecuali menurut kesanggupannya. Baginya ada sesuatu (pahala) dari (kebajikan) yang diusahakannya dan terhadapnya ada (pula) sesuatu (siksa) atas (kejahatan) yang diperbuatnya. (Mereka berdoa,) “Wahai Tuhan kami, janganlah Engkau hukum kami jika kami lupa atau kami salah. Wahai Tuhan kami, janganlah Engkau bebani kami dengan beban yang berat sebagaimana Engkau bebankan kepada orang-orang sebelum kami. Wahai Tuhan kami, janganlah Engkau pikulkan kepada kami apa yang tidak sanggup kami memikulnya. Maafkanlah kami, ampunilah kami, dan rahmatilah kami. Engkaulah pelindung kami. Maka, tolonglah kami dalam menghadapi kaum kafir.”"
    },
    {
      "juz": 3,
      "ayah": 8,
      "latin": "Rabbanā lā tuzig qulūbanā ba‘da iż hadaitanā wa hab lanā mil ladunka raḥmah(tan), innaka antal-wahhāb(u).  ",
      "surah": 3,
      "arabic": "رَبَّنَا لَا تُزِغْ قُلُوْبَنَا بَعْدَ اِذْ هَدَيْتَنَا وَهَبْ لَنَا مِنْ لَّدُنْكَ رَحْمَةً ۚاِنَّكَ اَنْتَ الْوَهَّابُ ",
      "ayahId": 301,
      "surahName": "Āli ‘Imrān",
      "mushafPage": 50,
      "translation": "(Mereka berdoa,) “Wahai Tuhan kami, janganlah Engkau jadikan hati kami berpaling setelah Engkau berikan petunjuk kepada kami dan anugerahkanlah kepada kami rahmat dari hadirat-Mu. Sesungguhnya Engkau Maha Pemberi."
    },
    {
      "juz": 3,
      "ayah": 74,
      "latin": "Yakhtaṣṣu biraḥmatihī may yasyā'(u), wallāhu żul-faḍlil-‘aẓīm(i).  ",
      "surah": 3,
      "arabic": "يَخْتَصُّ بِرَحْمَتِهٖ مَنْ يَّشَاۤءُ  ۗوَاللّٰهُ ذُو الْفَضْلِ الْعَظِيْمِ",
      "ayahId": 367,
      "surahName": "Āli ‘Imrān",
      "mushafPage": 59,
      "translation": "Dia menentukan rahmat-Nya kepada siapa yang Dia kehendaki dan Allah memiliki karunia yang besar."
    }
  ],
  "query": "rahmat",
  "scope": "translation",
  "surah": null,
  "total": 146,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 8
}
```

---

### Random Ayah

One random ayah, optionally restricted to a surah or juz.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:quran-kemenag/random-ayah`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `surah` | number | query | no | Restrict to one surah, 1-114 |
| `juz` | number | query | no | Restrict to one juz, 1-30 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:quran-kemenag/random-ayah?surah=2&juz=30" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:quran-kemenag/random-ayah?surah=2&juz=30", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:quran-kemenag/random-ayah?surah=2&juz=30",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "juz": 30,
  "ayah": 13,
  "latin": "Fī ṣuḥufim mukarrmah(tin).",
  "surah": 80,
  "arabic": "فِيْ صُحُفٍ مُّكَرَّمَةٍۙ",
  "ayahId": 5771,
  "poolSize": 564,
  "provider": "quran-kemenag",
  "surahName": "‘Abasa",
  "mushafPage": 585,
  "translation": "di dalam suhuf yang dimuliakan (di sisi Allah),"
}
```

---


_Generated: 2026-08-29T12:24:27.044Z_