A random hadith

Code snippets

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

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

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

Example response

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

{
    "data": {
        "hadith": {
            "text": "Narrated Ibn `Abbas:A man came to the Prophet (ﷺ) and said to him, \"My sister vowed to perform the Hajj, but she died (before fulfilling it).\" The Prophet (ﷺ) said, \"Would you not have paid her debts if she had any?\" The man said, \"Yes.\" The Prophet (ﷺ) said, \"So pay Allah's Rights, as He is more entitled to receive His rights",
            "grades": [],
            "number": 6699,
            "edition": "eng-bukhari",
            "reference": {
                "book": 83,
                "hadith": 76
            },
            "arabic_number": 6699
        },
        "collection": "Sahih al Bukhari"
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:29.119Z",
        "request_id": "10e81e01-b5f4-4db5-a6eb-045f2e2a2d90"
    },
    "status": "ok",
    "message": "Random hadith retrieved successfully",
    "success": true
}