API Indonesia logoAPI Indonesia

Core Products

More Products

See All APIs
New

Realtime Earthquake API

BMKG earthquake data, updated hourly.

Learn more
API Reference

Al-Quran

Complete list of 114 Al-Quran surahs with Arabic name, Latin transliteration, translation, number of verses, and revelation place. Static data sourced from quran.gading.dev.

Sign Up FreeView Full Docs
Main endpoint
GET https://use.apiindonesia.id/api/v1/quran/list-surah
Endpoints
2
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Complete list of 114 Al-Quran surahs with Arabic name, Latin transliteration, translation, number of verses, and revelation place. Static data sourced from quran.gading.dev.

Coverage
2

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/quran/list-surah

Returns the complete list of 114 Al-Quran surahs, ordered by number.

When should you use it?

The Quran API fits Islamic apps, ed-tech, dakwah content, and reference features that need surah data with Arabic names, transliteration, meaning, verse count, and revelation place.

The app needs surah navigation without maintaining its own dataset.

Content needs to show surah metadata consistently.

Quran-learning products need a basic reference for surah lists.

Check endpoint coverage before designing tafsir, audio, or verse-by-verse features. Not every Quran-content need is covered by the same product.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Muslim lifestyle & Islamic ed-tech apps: list surahs without maintaining your own Quran dataset.
  • Quran-memorization platforms: build surah navigation for Quran-learning apps.
  • Islamic content: auto-embed surah references in articles or media.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/quran/list-surah" \\
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": [
    {
      "id": 1,
      "name": "الفاتحة",
      "name_latin": "Al-Fatihah",
      "name_arabic": "الفاتحة",
      "name_translation": "Pembukaan",
      "number_of_ayahs": 7,
      "revelation_place": "mecca",
      "revelation_order": 5,
      "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/1.mp3"
    }
  ]
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Sign upSee plans

Al-Quran API questions

What does the surah list contain?

All 114 surahs with Arabic name, Latin transliteration, translation, verse count and place of revelation. Sourced from quran.gading.dev.

How do I fetch a single surah?

Call GET /api/v1/quran/surah/{id} with a surah number from 1 to 114.

Does the data change?

No. It is static data, so it is safe to cache on your side to save credits.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization