Hosted API access is disabled on `al-quran-database.vercel.app` for now. Use the repository locally or self-host this project to run the API endpoints documented here.

Surahs API

Access metadata for all 114 Surahs or fetch full Ayah payloads for a specific chapter.

List All Surahs

Returns a paginated list of all Surahs including Arabic names, translations, and revelation types.

GET/api/v1/surahs?page=1&limit=10

Click "Run" to see live API response...

Get Surah by ID

Fetch detailed information about a specific Surah, including all its Ayahs with the default translation.

GET/api/v1/surahs/1

Click "Run" to see live API response...

With Custom Edition

Optionally include a specific translation edition in the response.

GET/api/v1/surahs/1?edition=en.sahih

Click "Run" to see live API response...