A random joke

Code snippets

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

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

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

Example response

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

{
    "data": {
        "joke": {
            "id": "i8k15bwdq4iwpdz3__u8fg",
            "url": "https://api.chucknorris.io/jokes/i8k15bwdq4iwpdz3__u8fg",
            "joke": "Chuck Norris' programs never exit, they terminate.",
            "icon_url": "https://api.chucknorris.io/img/avatar/chuck-norris.png",
            "categories": [
                "dev"
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:48:46.331Z",
        "request_id": "ec848dc9-8de3-43fd-812d-be600977f332"
    },
    "status": "ok",
    "message": "Joke retrieved successfully",
    "success": true
}