A verse (Arabic + translation)

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/quran-api/v1/ayah");
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/ayah",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "ayah": {
            "juz": 3,
            "page": 42,
            "sajda": false,
            "surah": {
                "name": "سُورَةُ البَقَرَةِ",
                "number": 2,
                "english_name": "Al-Baqara",
                "revelation_type": "Medinan",
                "english_translation": "The Cow"
            },
            "arabic": "ٱللَّهُ لَآ إِلَٰهَ إِلَّا هُوَ ٱلْحَىُّ ٱلْقَيُّومُ ۚ لَا تَأْخُذُهُۥ سِنَةٌۭ وَلَا نَوْمٌۭ ۚ لَّهُۥ مَا فِى ٱلسَّمَٰوَٰتِ وَمَا فِى ٱلْأَرْضِ ۗ مَن ذَا ٱلَّذِى يَشْفَعُ عِندَهُۥٓ إِلَّا بِإِذْنِهِۦ ۚ يَعْلَمُ مَا بَيْنَ أَيْدِيهِمْ وَمَا خَلْفَهُمْ ۖ وَلَا يُحِيطُونَ بِشَىْءٍۢ مِّنْ عِلْمِهِۦٓ إِلَّا بِمَا شَآءَ ۚ وَسِعَ كُرْسِيُّهُ ٱلسَّمَٰوَٰتِ وَٱلْأَرْضَ ۖ وَلَا يَـُٔودُهُۥ حِفْظُهُمَا ۚ وَهُوَ ٱلْعَلِىُّ ٱلْعَظِيمُ",
            "edition": "Muhammad Asad",
            "reference": "2:255",
            "ayah_number": 255,
            "translation": "GOD - there is no deity save Him, the Ever-Living, the Self-Subsistent Fount of All Being. Neither slumber overtakes Him, nor sleep. His is all that is in the heavens and all that is on earth. Who is there that could intercede with Him, unless it be by His leave? He knows all that lies open before men and all that is hidden from them, whereas they cannot attain to aught of His knowledge save that which He wills [them to attain]. His eternal power overspreads the heavens and the earth, and their upholding wearies Him not. And he alone is truly exalted, tremendous.",
            "number_in_quran": 262
        }
    },
    "meta": {
        "timestamp": "2026-05-31T15:55:08.601Z",
        "request_id": "b4fd8cf7-7efa-4fd1-a025-ef6e10981aee"
    },
    "status": "ok",
    "message": "Ayah retrieved",
    "success": true
}