How to hit the AlQuran Cloud API

AlQuran Cloud at https://api.alquran.cloud/v1 serves the Quran in Arabic, translations, and recitations by edition.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://alquran.cloud/api

Get a verse in a translation

Surah:ayah, then the edition.

curl https://api.alquran.cloud/v1/ayah/1:1/en.asad
Run in PostTaco
Example response (trimmed)
{
  "code": 200,
  "status": "OK",
  "data": {
    "number": 1,
    "text": "In the name of God, The Most Gracious, The Dispenser of Grace:",
    "edition": {
      "identifier": "en.asad",
      "language": "en",
      "name": "Asad",
      "englishName": "Muhammad Asad",
      "format": "text",
      "type": "translation",
      "direction": "ltr"
    },
    "surah": {
      "number": 1,
      "name": "سُورَةُ ٱلْفَاتِحَةِ",
      "englishName": "Al-Faatiha",
      "englishNameTranslation": "The Opening",
      "numberOfAyahs": 7,
      "revelationType": "Meccan"
    },
    "numberInSurah": 1,
    "juz": 1,
    "manzil": 1,
    "page": 1,
    "ruku": 1,
    "hizbQuarter": 1,
    "sajda": false
  }
}

List editions

curl "https://api.alquran.cloud/v1/edition?format=text&language=en"
Run in PostTaco
Example response (trimmed)
{
  "code": 200,
  "status": "OK",
  "data": [
    {
      "identifier": "en.ahmedali",
      "language": "en",
      "name": "Ahmed Ali",
      "englishName": "Ahmed Ali",
      "format": "text",
      "type": "translation",
      "direction": "ltr"
    },
    {
      "identifier": "en.ahmedraza",
      "language": "en",
      "name": "Ahmed Raza Khan",
      "englishName": "Ahmed Raza Khan",
      "format": "text",
      "type": "translation",
      "direction": "ltr"
    }
  ]
}