A single hadith by number

Code snippets

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

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

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

Example response

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

{
    "data": {
        "hadith": {
            "text": "Narrated 'Umar bin Al-Khattab: I heard Allah's Messenger (ﷺ) saying, \"The reward of deeds depends upon the intentions and every person will get the reward according to what he has intended. So whoever emigrated for worldly benefits or for a woman to marry, his emigration was for what he emigrated for",
            "grades": [],
            "number": 1,
            "edition": "eng-bukhari",
            "reference": {
                "book": 1,
                "hadith": 1
            },
            "arabic_number": 1
        },
        "collection": "Sahih al Bukhari"
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:02.663Z",
        "request_id": "e5a54975-3f2b-48cf-a599-0c4bb19f3c6c"
    },
    "status": "ok",
    "message": "Hadith retrieved successfully",
    "success": true
}