Jewish holidays for a year

Code snippets

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

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

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

Example response

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

{
    "data": {
        "year": 2025,
        "count": 90,
        "holidays": [
            {
                "date": "2025-01-01",
                "title": "Chanukah: 8 Candles",
                "hebrew": "חנוכה: ח׳ נרות",
                "subcat": "major",
                "category": "holiday",
                "description": "Hanukkah, the Jewish festival of rededication. Also known as the Festival of Lights, the eight-day festival is observed by lighting the candles of a hanukkiah (menorah)"
            },
            {
                "date": "2025-01-01",
                "title": "Rosh Chodesh Tevet",
                "hebrew": "ראש חודש טבת",
                "subcat": null,
                "category": "roshchodesh",
                "description": "Start of month of Tevet on the Hebrew calendar. Tevet (טֵבֵת) is the 4th month of the civil Hebrew year and the 10th month of the biblical Hebrew year. It has 29 days and corresponds to December or January on the Gregorian calendar. רֹאשׁ חוֹדֶשׁ, transliterated Rosh Chodesh or Rosh Hodesh, is a minor holiday that occurs at the beginning of every month in the Hebrew calendar. It is marked by the birth of a new moon"
            },
            {
                "date": "2025-01-02",
                "title": "Chanukah: 8th Day",
                "hebrew": "חנוכה: יום ח׳",
                "subcat": "major",
                "category": "holiday",
                "description": "Hanukkah, the Jewish festival of rededication. Also known as the Festival of Lights, the eight-day festival is observed by lighting the candles of a hanukkiah (menorah)"
            },
            {
                "date": "2025-01-10",
                "title": "Asara B’Tevet",
                "hebrew": "עשרה בטבת",
                "subcat": "fast",
                "category": "holiday",
                "description": "Fast commemorating the siege of Jerusalem"
            },
            {
                "date": "2025-01-30",
                "title": "Rosh Chodesh Sh’vat",
                "hebrew": "ראש חודש שבט",
                "subcat": null,
                "category": "roshchodesh",
                "description": "Start of month of Sh’vat on the Hebrew calendar. שְׁבָט (transliterated Sh’vat or Shevat) is the 5th month of the civil Hebrew year and the 11th month of the biblical Hebrew year. It has 30 days and corresponds to January or February on the Gregorian calendar. רֹאשׁ חוֹדֶשׁ, transliterated Rosh Chodesh or Rosh Hodesh, is a minor holiday that occurs at the beginning of every month in the Hebrew calendar. It is marked by the birth of a new moon"
            },
            {
                "date": "2025-02-08",
                "title": "Shabbat Shirah",
                "hebrew": "שבת שירה",
                "subcat": "shabbat",
                "category": "holiday",
                "description": "Shabbat of Song. Shabbat that includes Parashat Beshalach"
            },
            {
                "date": "2025-02
…