QuranEnc.com API specs

Endpoints:


Available translations

GET / https://quranenc.com/api/v1/translations/list/[[{language}]]/?localization={language_iso_code}
description: get the available translations

Parameters:
language: Optional, if ommited the endpoint will return all available translations, used to filter the translations by a specific language (by its iso code), here is a list of the available languages
localization: (query param) Optional defaults to "en", used to localize translation title and description in the specified language (by its iso code), here is a list of the available locales

Returns:
json object containing array of objects, each object contains the translation's "key", "language_iso_code", "version", "last_update" (timestamp), "title" and "description" (in the specified localization).

example:
https://quranenc.com/api/v1/translations/list


Sura translation

GET / https://quranenc.com/api/v1/translation/sura/{translation_key}/{sura_number}
description: get the specified translation (by its translation_key) for the speicified sura (by its number)

Parameters:
translation_key: (the key of the currently selected translation)
sura_number: [1-114] (Sura number in the mosshaf which should be between 1 and 114)

Returns:
json object containing array of objects, each object contains the "sura", "aya", "translation" and "footnotes".

example:
https://quranenc.com/api/v1/translation/sura/english_saheeh/1


Aya translation

GET / https://quranenc.com/api/v1/translation/aya/{translation_key}/{sura_number}/{aya_number}
description: get the specified translation (by its translation_key) for the speicified aya (by its number sura_number and aya_number)

Parameters:
translation_key: (the key of the currently selected translation)
sura_number: [1-114] (Sura number in the mosshaf which should be between 1 and 114)
aya_number: [1-...] (Aya number in the sura)

Returns:
json object containing the "sura", "aya", "translation" and "footnotes".

example:
https://quranenc.com/api/v1/translation/aya/english_saheeh/1/1