Holidays & observances on a date

Code snippets

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

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

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

Example response

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

{
    "data": {
        "date": "12-25",
        "count": 10,
        "items": [
            {
                "url": "https://en.wikipedia.org/wiki/Christmas",
                "page": "Christmas",
                "text": "Christmas Day, Christian festival commemorating the birth of Jesus. (Internationally observed)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Anastasia_of_Sirmium",
                "page": "Anastasia of Sirmium",
                "text": "Christian feast day:\nAnastasia of Sirmium (Catholic Church)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Saint_Stephen",
                "page": "Saint Stephen",
                "text": "Christian feast day:\nStephen (Armenian Apostolic Church)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/December_25_(Eastern_Orthodox_liturgics)",
                "page": "December 25 (Eastern Orthodox liturgics)",
                "text": "Christian feast day:\nDecember 25 (Eastern Orthodox liturgics)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Children's_Day",
                "page": "Children's Day",
                "text": "Children's Day (Cameroon, Central African Republic, Chad, Equatorial Guinea, Democratic Republic of the Congo, Gabon, Republic of Congo)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Asaram",
                "page": "Asaram",
                "text": "Tulsi Pujan Diwas (India)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan",
                "page": "Public holidays in Taiwan",
                "text": "Constitution Day (Taiwan)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Good_Governance_Day",
                "page": "Good Governance Day",
                "text": "Good Governance Day (India)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Jinnah's_birthday",
                "page": "Jinnah's birthday",
                "text": "Quaid-e-Azam's Day (Pakistan)",
                "year": null
            },
            {
                "url": "https://en.wikipedia.org/wiki/Takanakuy",
                "page": "Takanakuy",
                "text": "Takanakuy (Chumbivilcas Province, Peru)",
                "year": null
            }
        ],
        "label": "December 25",
        "category": "holidays"
    },
    "meta": {
        "timestamp": "2026-05-31T06:28:04.968Z",
        "request_id": "ab636973-0eba-4607-96b8-36211296289b"
    },
    "status": "ok",
    "message": "Holidays retrieved",
    "success": true
}