Free Quran and Hadith translation downloads

Quran translations

Every entry covers all 114 surahs (6,236 ayahs). Arabic ships the Uthmani mushaf from quran.com in full. Modern translations are translator-copyrighted — we expose the provenance metadata so you can fetch the text directly from the upstream source.

Hadith collections

Nine collections, four languages where coverage exists. Arabic editions are public-domain classical text (aggregated by fawazahmed0/hadith-api); modern translations are translator-copyrighted and metadata-only here.

How to use the data

Every endpoint returns a single JSON object. The envelope carries the provenance fields (attribution, license, source_url, redistribute, notice), then a count and an itemsarray. When the licence forbids redistribution, each item's text is null — fetch from source_url instead.

# discover everything
curl https://i-muslim.com/api/v1/translations

# full text — Arabic Quran (public domain)
curl https://i-muslim.com/api/v1/translations/quran/ar

# metadata only — Saheeh International (translator copyright)
curl https://i-muslim.com/api/v1/translations/quran/en

# full text — Bukhari Arabic (classical text)
curl https://i-muslim.com/api/v1/translations/hadith/bukhari/ar

# single surah for lighter payloads
curl https://i-muslim.com/api/v1/translations/quran/ar/1

Need a richer surface (per-ayah, per-hadith, with translations as query parameters, plus write access for your own translations)? See the Developer API docs — those endpoints require an API key but cover the same data at a finer grain.

Licence model

There is no single licence covering the whole dataset. Each translation is governed by the licence of its original publisher, and the API response carries that licence verbatim. Two redistribute modes:

• Full text — the API returns text verbatim. Currently the Arabic Quran (Uthmani mushaf) and the Arabic Hadith editions — both classical, public-domain text.
• Metadata only — the API returns the attribution, licence label and upstream URL, but text is null. Applies to every modern translator-authored translation (Saheeh International, Kuliev, Musayev, Diyanet, and the fawazahmed0-aggregated Hadith translations) until we have an open-licence grant on file. Fetch the text directly from source_url.

We default to metadata onlywhenever a translation's redistribution licence is unclear. If you hold the copyright on one of these translations and want to release it under an open licence so the text can ship in full, please get in touch — we'd love to.

Contribute or correct a translation

Spotted an error? Want to contribute a translation you wrote yourself and own? Send it through the contact form with subject “Translation contribution”— include the diff, the source you took the text from, and the licence you're releasing your contribution under. We'll review and merge.

Open contribution form →

Versioning

These downloads sit under /api/v1/ — the stable surface. Any breaking change to the JSON shape ships under v2; we'll keep v1 running for at least 12 months after. Adding a new translation, a new licence row, or flipping a row from metadata-only to full text is not a breaking change.