zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Indonesia/Al-Qur'an Kemenag
Logo Al-Qur'an Kemenag

Al-Qur'an 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).

Endpoints
14
Requests
242
Updated
3 hours ago
For LLMs
llms.txt
Endpoint healthnot yet measured
  • surah-listnot measured
  • surah-detailnot measured
  • ayah-listnot measured
  • ayah-detailnot measured
  • ayah-by-juznot measured
+ 9 more endpointsShow less
  • ayah-by-pagenot measured
  • ayah-wordsnot measured
  • tafsir-ayahnot measured
  • tafsir-wajiznot measured
  • tafsir-tahlilinot measured
  • sabab-nuzulnot measured
  • surah-overviewnot measured
  • searchnot measured
  • random-ayahnot measured
no measurements yetdaily 01:00 WIB

Playground

14 endpoints
GET/v1/indonesia:quran-kemenag/surah-list10m cache4 paramschecking key…
Parameters
keywordstring

Filter by surah name or translation

revelationenum

Filter by revelation place. Default all

pagenumber

Page number (starts at 1). Default 1

countnumber

Items per page. Default 114, max 114

·
Response
EXAMPLE
{
  "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"
    }
  ],
  "total": 114,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10,
  "revelation": "all"
}

Code examples

Surah List
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("indonesia:quran-kemenag", "surah-list", {
  "keyword": "baqarah",
  "page": 1
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list?keyword=baqarah&revelation=&page=1&count=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

14 endpoints · plain text
GETSurah List/v1/indonesia:quran-kemenag/surah-listAll 114 surah with name, ayah count, revelation place and starting mushaf page.

Parameters

keywordstringoptional
Filter by surah name or translation
revelationenumoptional
Filter by revelation place. Default all Values: all, makkiyah, madaniyah.
pagenumberoptional
Page number (starts at 1). Default 1
countnumberoptional
Items per page. Default 114, max 114

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-list?keyword=baqarah&revelation=&page=1&count=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
    }
  ],
  "total": 114,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10,
  "revelation": "all"
}
GETSurah Detail/v1/indonesia:quran-kemenag/surah-detailOne surah's metadata by number.

Parameters

surahnumberrequired
Surah number, 1-114

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-detail?surah=2" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "name": "Al-Baqarah",
  "surah": 2,
  "provider": "quran-kemenag",
  "ayahCount": 286,
  "startPage": 2,
  "nameArabic": "البقرة",
  "revelation": "Madaniyah",
  "translation": "Sapi",
  "transliteration": "Al-Baqarah"
}
GETAyah List/v1/indonesia:quran-kemenag/ayah-listPaged ayah of one surah, full text and position.

Parameters

surahnumberrequired
Surah number, 1-114
pagenumberoptional
Page number (starts at 1). Default 1
countnumberoptional
Items per page. Default 50, max 300

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-list?surah=2&page=1&count=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
    }
  ],
  "surah": 36,
  "total": 83,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10,
  "surahName": "Yāsīn"
}
GETAyah Detail/v1/indonesia:quran-kemenag/ayah-detailOne ayah: Arabic, kitabah, transliteration, translation, footnotes and position.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-detail?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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‘la…",
  "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 d…"
}
GETAyah by Juz/v1/indonesia:quran-kemenag/ayah-by-juzPaged ayah of one juz (1-30).

Parameters

juznumberrequired
Juz number, 1-30
pagenumberoptional
Page number (starts at 1). Default 1
countnumberoptional
Items per page. Default 50, max 300

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-juz?juz=30&page=1&count=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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)"
    }
  ],
  "total": null,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 10
}
GETAyah by Mushaf Page/v1/indonesia:quran-kemenag/ayah-by-pageEvery ayah printed on one standard mushaf page (1-604).

Parameters

mushafPagenumberrequired
Mushaf page number, 1-604

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-by-page?mushafPage=1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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-…",
      "surahName": "Al-Fātiḥah",
      "updatedAt": "2025-09-17T11:41:27.000Z",
      "mushafPage": 1,
      "quarterHizb": 1,
      "translation": "Segala puji bagi Allah, Tuhan1) semesta alam"
    }
  ],
  "provider": "quran-kemenag",
  "mushafPage": 1
}
GETAyah Word by Word/v1/indonesia:quran-kemenag/ayah-wordsPer-word breakdown of one ayah.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/ayah-words?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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."
}
GETTafsir (Full)/v1/indonesia:quran-kemenag/tafsir-ayahComplete Kemenag tafsir for one ayah: wajiz, tahlili, kosakata, sabab nuzul, munasabah, surah intro/outro and conclusion.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-ayah?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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‘la…",
  "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-…",
  "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 alas…",
  "kosakata": "Kosakata: Kursi كُرْسِيٌّ (al-Baqarah/2: 255)\nSecara etimologis, kursi berarti tempat duduk, singgasana atau tahta (ṣād/38: 34). Asal katanya الكرسي artinya tempat berkumpul. Segal…",
  "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…",
  "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 s…",
  "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 d…",
  "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 …",
  "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…"
}
GETTafsir Wajiz/v1/indonesia:quran-kemenag/tafsir-wajizShort-form Kemenag tafsir for one ayah.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-wajiz?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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‘la…",
  "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-…",
  "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 d…"
}
GETTafsir Tahlili/v1/indonesia:quran-kemenag/tafsir-tahliliLong-form analytical Kemenag tafsir for one ayah.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/tafsir-tahlili?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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‘la…",
  "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 alas…",
  "kosakata": "Kosakata: Kursi كُرْسِيٌّ (al-Baqarah/2: 255)\nSecara etimologis, kursi berarti tempat duduk, singgasana atau tahta (ṣād/38: 34). Asal katanya الكرسي artinya tempat berkumpul. Segal…",
  "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 d…"
}
GETSabab Nuzul/v1/indonesia:quran-kemenag/sabab-nuzulOccasion of revelation for one ayah, where the source records one.

Parameters

surahnumberrequired
Surah number, 1-114
ayahnumberrequired
Ayah number within the surah, 1-286

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/sabab-nuzul?surah=2&ayah=255" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}
GETSurah Overview/v1/indonesia:quran-kemenag/surah-overviewSurah introduction, closing, theme group and relation to the previous surah.

Parameters

surahnumberrequired
Surah number, 1-114

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/surah-overview?surah=2" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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 s…",
  "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 …"
}
GETSearch Ayah/v1/indonesia:quran-kemenag/searchSearch the whole Qur'an by translation, transliteration or Arabic text, optionally scoped to a surah or juz.

Parameters

qstringrequired
Search term, at least 2 characters
scopeenumoptional
Field to search. Default translation Values: translation, latin, arabic, all.
surahnumberoptional
Restrict to one surah, 1-114
juznumberoptional
Restrict to one juz, 1-30
pagenumberoptional
Page number (starts at 1). Default 1
countnumberoptional
Items per page. Default 20, max 100

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/search?q=rahmat&scope=&surah=2&juz=30&page=1&count=" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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 memberika…"
    }
  ],
  "query": "rahmat",
  "scope": "translation",
  "surah": null,
  "total": 146,
  "hasMore": true,
  "nextPage": 2,
  "provider": "quran-kemenag",
  "returned": 8
}
GETRandom Ayah/v1/indonesia:quran-kemenag/random-ayahOne random ayah, optionally restricted to a surah or juz.

Parameters

surahnumberoptional
Restrict to one surah, 1-114
juznumberoptional
Restrict to one juz, 1-30

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:quran-kemenag/random-ayah?surah=2&juz=30" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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),"
}

Related APIs

More in indonesia

Jadwal Sholat & Hijriah

indonesia/sholat-kemenag

Indonesian prayer schedules for 517 cities sourced from the Ministry of Religious Affairs dataset, plus Hijri/Gregorian conversion and qibla direction.

188 calls·10m cache

Bimas Islam Kemenag

indonesia/bimasislam

Directorate General of Islamic Community Guidance: sharia consultation Q&A answered by the Kemenag team, official news, and directorate profile pages.

82 calls·10m cache

Cek BPOM

indonesia/cek-bpom

Pencarian registrasi produk obat, kosmetik, suplemen, dan pangan pada database resmi BPOM RI.

38 calls·5m cache

LPSE / Tender Pemerintah

indonesia/lpse

Data tender & pengadaan pemerintah Indonesia dari sumber nasional (Satu Data LKPP). Cari paket tender lintas instansi, lihat detail tender (pagu/HPS/jadwal/anggaran), dan direktori kode LPSE.

30 calls·30m cache

Cek NIK

indonesia/cek-nik

Decode structural information from a 16-digit Indonesian NIK identifier.

23 calls·5m cache

Cek Kode Pos

indonesia/cek-kode-pos

Cari kode pos Indonesia berdasarkan nama kelurahan, kecamatan, atau kota.

22 calls·5m cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026