A full chapter

Code snippets

curl "https://api.oanor.com/quran-api/v1/surah" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/quran-api/v1/surah", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/quran-api/v1/surah");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/quran-api/v1/surah",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "surah": {
            "name": "سُورَةُ ٱلْفَاتِحَةِ",
            "ayahs": [
                {
                    "ayah": 1,
                    "arabic": "بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ",
                    "translation": "In the name of God, The Most Gracious, The Dispenser of Grace:"
                },
                {
                    "ayah": 2,
                    "arabic": "ٱلْحَمْدُ لِلَّهِ رَبِّ ٱلْعَٰلَمِينَ",
                    "translation": "All praise is due to God alone, the Sustainer of all the worlds,"
                },
                {
                    "ayah": 3,
                    "arabic": "ٱلرَّحْمَٰنِ ٱلرَّحِيمِ",
                    "translation": "The Most Gracious, the Dispenser of Grace,"
                },
                {
                    "ayah": 4,
                    "arabic": "مَٰلِكِ يَوْمِ ٱلدِّينِ",
                    "translation": "Lord of the Day of Judgment!"
                },
                {
                    "ayah": 5,
                    "arabic": "إِيَّاكَ نَعْبُدُ وَإِيَّاكَ نَسْتَعِينُ",
                    "translation": "Thee alone do we worship; and unto Thee alone do we turn for aid."
                },
                {
                    "ayah": 6,
                    "arabic": "ٱهْدِنَا ٱلصِّرَٰطَ ٱلْمُسْتَقِيمَ",
                    "translation": "Guide us the straight way."
                },
                {
                    "ayah": 7,
                    "arabic": "صِرَٰطَ ٱلَّذِينَ أَنْعَمْتَ عَلَيْهِمْ غَيْرِ ٱلْمَغْضُوبِ عَلَيْهِمْ وَلَا ٱلضَّآلِّينَ",
                    "translation": "The way of those upon whom Thou hast bestowed Thy blessings, not of those who have been condemned [by Thee], nor of those who go astray!"
                }
            ],
            "number": 1,
            "edition": "Muhammad Asad",
            "ayah_count": 7,
            "english_name": "Al-Faatiha",
            "revelation_type": "Meccan",
            "english_translation": "The Opening"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T15:55:08.763Z",
        "request_id": "810a4c7a-d651-4b60-9175-4cc54d8e999b"
    },
    "status": "ok",
    "message": "Surah retrieved",
    "success": true
}