{"openapi":"3.1.0","info":{"title":"Jewish Calendar API","version":"1.0.0","description":"The Jewish calendar as an API — powered by Hebcal. Convert any date between the Gregorian and Hebrew calendars (with the formatted Hebrew date and the Jewish events falling on that day), list the Jewish holidays of any year — major and minor festivals, Rosh Chodesh and special Shabbatot — each with its English and Hebrew name, date and category, and get this week's Shabbat candle-lighting time, Torah portion (parashah) and Havdalah time for any location by GeoNames id or coordinates. From Rosh Hashanah and Yom Kippur to Passover, Shavuot and Hanukkah, with Hebrew dates rendered in Hebrew script, it is ideal for calendar, scheduling, event, religious and cultural applications. A Jewish-calendar resource — distinct from secular public-holiday and Islamic prayer-time APIs. Open data from Hebcal (CC-BY 4.0 / GPL).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hebcal-api","description":"oanor gateway"}],"tags":[{"name":"Jewish Calendar"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Jewish Calendar"],"summary":"Convert Gregorian <-> Hebrew date","description":"","parameters":[{"name":"gy","in":"query","required":false,"description":"Gregorian year (with gm, gd)","schema":{"type":"string"},"example":"2025"},{"name":"gm","in":"query","required":false,"description":"Gregorian month 1-12","schema":{"type":"string"},"example":"6"},{"name":"gd","in":"query","required":false,"description":"Gregorian day 1-31","schema":{"type":"string"},"example":"1"},{"name":"hy","in":"query","required":false,"description":"Hebrew year (with hm, hd) for reverse","schema":{"type":"string"}},{"name":"hm","in":"query","required":false,"description":"Hebrew month name or number","schema":{"type":"string"}},{"name":"hd","in":"query","required":false,"description":"Hebrew day 1-30","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"events":["Erev Shavuot","Parashat Nasso","49th day of the Omer"],"hebrew":{"day":5,"year":5785,"month":"Sivan","display":"ה׳ בְּסִיוָן תשפ״ה"},"gregorian":{"day":1,"year":2025,"month":6}},"meta":{"timestamp":"2026-06-01T16:22:55.640Z","request_id":"bda466a0-76c6-4260-85a6-4faf5e246d95"},"status":"ok","message":"Date converted","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/holidays":{"get":{"operationId":"get_v1_holidays","tags":["Jewish Calendar"],"summary":"Jewish holidays for a year","description":"","parameters":[{"name":"year","in":"query","required":false,"description":"Gregorian year","schema":{"type":"string"},"example":"2025"},{"name":"month","in":"query","required":false,"description":"Optional month 1-12","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":"ראש חודש טבת","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":"ראש חודש שבט","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-13","title":"Tu BiShvat","hebrew":"ט״ו בשבט","subcat":"minor","category":"holiday","description":"New Year for Trees. Tu BiShvat is one of four “New Years” mentioned in the Mishnah"},{"date":"2025-02-28","title":"Rosh Chodesh Adar","hebrew":"ראש חודש אדר","category":"roshchodesh","description":"Start of month of Adar on the Hebrew calendar. Adar (אֲדָר) is the 6th month of the civil Hebrew year and the 12th month of the biblical Hebrew year. It has 29 days and corresponds to February or March 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-03-01","title":"Shabbat Shekalim","hebrew":"שבת שקלים","subcat":"shabbat","category":"holiday","description":"Shabbat before Rosh Chodesh Adar. Read in preparation for Purim"},{"date":"2025-03-01","title":"Rosh Chodesh Adar","hebrew":"ראש חודש אדר","category":"roshchodesh","description":"Start of month of Adar on the Hebrew calendar. Adar (אֲדָר) is the 6th month of the civil Hebrew year and the 12th month of the biblical Hebrew year. It has 29 days and corresponds to February or March 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-03-08","title":"Shabbat Zachor","hebrew":"שבת זכור","subcat":"shabbat","category":"holiday","description":"Shabbat of Remembrance. Shabbat before Purim"},{"date":"2025-03-13","title":"Ta’anit Esther","hebrew":"תענית אסתר","subcat":"fast","category":"holiday","description":"Fast of Esther"},{"date":"2025-03-13","title":"Erev Purim","hebrew":"ערב פורים","subcat":"major","category":"holiday","description":"Celebration of Jewish deliverance as told by Megilat Esther. It commemorates a time when the Jewish people living in Persia were saved from extermination"},{"date":"2025-03-14","title":"Purim","hebrew":"פורים","subcat":"major","category":"holiday","description":"Celebration of Jewish deliverance as told by Megilat Esther. It commemorates a time when the Jewish people living in Persia were saved from extermination"},{"date":"2025-03-15","title":"Shushan Purim","hebrew":"שושן פורים","subcat":"minor","category":"holiday","description":"Purim celebrated in Jerusalem and walled cities"},{"date":"2025-03-16","title":"Purim Meshulash","hebrew":"פורים משולש","subcat":"minor","category":"holiday","description":"Triple Purim, spanning 3 days in Jerusalem and walled cities. It occurs when the 15th of Adar coincides with Shabbat"},{"date":"2025-03-22","title":"Shabbat Parah","hebrew":"שבת פרה","subcat":"shabbat","category":"holiday","description":"Shabbat of the Red Heifer. Shabbat before Shabbat HaChodesh, in preparation for Passover"},{"date":"2025-03-29","title":"Shabbat HaChodesh","hebrew":"שבת החדש","subcat":"shabbat","category":"holiday","description":"Shabbat before Rosh Chodesh Nissan. Read in preparation for Passover"},{"date":"2025-03-30","title":"Rosh Chodesh Nisan","hebrew":"ראש חודש ניסן","category":"roshchodesh","description":"Start of month of Nisan on the Hebrew calendar. נִיסָן (transliterated Nisan or Nissan) is the 7th month of the civil Hebrew year (8th on leap years) and the 1st month of the biblical Hebrew year. It has 30 days and corresponds to March or April 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-04-08","title":"Yom HaAliyah","hebrew":"יום העליה","subcat":"modern","category":"holiday","description":"Recognizes Aliyah, immigration to the Jewish State of Israel"},{"date":"2025-04-10","title":"Ta’anit Bechorot","hebrew":"תענית בכורות","subcat":"fast","category":"holiday","description":"Fast of the First Born"},{"date":"2025-04-12","title":"Shabbat HaGadol","hebrew":"שבת הגדול","subcat":"shabbat","category":"holiday","description":"Shabbat before Pesach (The Great Shabbat)"},{"date":"2025-04-12","title":"Erev Pesach","hebrew":"ערב פסח","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-13","title":"Pesach I","hebrew":"פסח א׳","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-14","title":"Pesach II","hebrew":"פסח ב׳","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-15","title":"Pesach III (CH’’M)","hebrew":"פסח ג׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-16","title":"Pesach IV (CH’’M)","hebrew":"פסח ד׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-17","title":"Pesach V (CH’’M)","hebrew":"פסח ה׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-18","title":"Pesach VI (CH’’M)","hebrew":"פסח ו׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-19","title":"Pesach VII","hebrew":"פסח ז׳","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-20","title":"Pesach VIII","hebrew":"פסח ח׳","subcat":"major","category":"holiday","description":"Passover, the Feast of Unleavened Bread. Also called Chag HaMatzot (the Festival of Matzah), it commemorates the Exodus and freedom of the Israelites from ancient Egypt"},{"date":"2025-04-24","title":"Yom HaShoah","hebrew":"יום השואה","subcat":"modern","category":"holiday","description":"Holocaust Memorial Day"},{"date":"2025-04-28","title":"Rosh Chodesh Iyyar","hebrew":"ראש חודש אייר","category":"roshchodesh","description":"Start of month of Iyyar on the Hebrew calendar. אִיָּיר (transliterated Iyyar or Iyar) is the 8th month of the civil Hebrew year (9th on leap years) and the 2nd month of the biblical Hebrew year. It has 29 days and corresponds to April or May 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-04-29","title":"Rosh Chodesh Iyyar","hebrew":"ראש חודש אייר","category":"roshchodesh","description":"Start of month of Iyyar on the Hebrew calendar. אִיָּיר (transliterated Iyyar or Iyar) is the 8th month of the civil Hebrew year (9th on leap years) and the 2nd month of the biblical Hebrew year. It has 29 days and corresponds to April or May 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-04-30","title":"Yom HaZikaron","hebrew":"יום הזכרון","subcat":"modern","category":"holiday","description":"Israeli Memorial Day. Remembers those who died in the War of Independence and other wars in Israel. The full name of the holiday is Yom HaZikaron LeHalalei Ma’arakhot Yisrael ul’Nifge’ei Pe’ulot HaEivah (Hebrew: יוֹם הזִּכָּרוֹן לְחַלְלֵי מַעֲרָכוֹת יִשְׂרָאֵל וּלְנִפְגְעֵי פְּעֻלּוֹת הָאֵיבָה), Memorial Day for the Fallen Soldiers of the Wars of Israel and Victims of Actions of Terrorism. Although Yom Hazikaron is normally observed on the 4th of Iyyar, it may be moved earlier or postponed if observance of the holiday (or Yom HaAtzma’ut, which always follows it) would conflict with Shabbat"},{"date":"2025-05-01","title":"Yom HaAtzma’ut","hebrew":"יום העצמאות","subcat":"modern","category":"holiday","description":"Israeli Independence Day. Commemorates the declaration of independence of Israel in 1948. Although Yom HaAtzma’ut is normally observed on the 5th of Iyyar, it may be moved earlier or postponed if observance of the holiday (or Yom HaZikaron, which always precedes it) would conflict with Shabbat"},{"date":"2025-05-12","title":"Pesach Sheni","hebrew":"פסח שני","subcat":"minor","category":"holiday","description":"Second Passover, one month after Passover"},{"date":"2025-05-16","title":"Lag BaOmer","hebrew":"ל״ג בעומר","subcat":"minor","category":"holiday","description":"33rd day of counting the Omer. The holiday is a temporary break from the semi-mourning period the counting of the Omer. Practices include lighting bonfires, getting haircuts, and Jewish weddings"},{"date":"2025-05-26","title":"Yom Yerushalayim","hebrew":"יום ירושלים","subcat":"modern","category":"holiday","description":"Jerusalem Day. Commemorates the re-unification of Jerusalem in 1967"},{"date":"2025-05-28","title":"Rosh Chodesh Sivan","hebrew":"ראש חודש סיון","category":"roshchodesh","description":"Start of month of Sivan on the Hebrew calendar. Sivan (סִיוָן) is the 9th month of the civil Hebrew year (10th on leap years) and the 3rd month of the biblical Hebrew year. It has 30 days and corresponds to May or June 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-06-01","title":"Erev Shavuot","hebrew":"ערב שבועות","subcat":"major","category":"holiday","description":"Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"},{"date":"2025-06-02","title":"Shavuot I","hebrew":"שבועות א׳","subcat":"major","category":"holiday","description":"Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"},{"date":"2025-06-03","title":"Shavuot II","hebrew":"שבועות ב׳","subcat":"major","category":"holiday","description":"Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"},{"date":"2025-06-26","title":"Rosh Chodesh Tamuz","hebrew":"ראש חודש תמוז","category":"roshchodesh","description":"Start of month of Tammuz on the Hebrew calendar. תַּמּוּז (transliterated Tamuz or Tammuz) is the 10th month of the civil Hebrew year (11th on leap years) and the 4th month of the biblical Hebrew year. It has 29 days and corresponds to June or July 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-06-27","title":"Rosh Chodesh Tamuz","hebrew":"ראש חודש תמוז","category":"roshchodesh","description":"Start of month of Tammuz on the Hebrew calendar. תַּמּוּז (transliterated Tamuz or Tammuz) is the 10th month of the civil Hebrew year (11th on leap years) and the 4th month of the biblical Hebrew year. It has 29 days and corresponds to June or July 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-07-13","title":"Tzom Tammuz","hebrew":"צום י״ז בתמוז","subcat":"fast","category":"holiday","description":"Fast commemorating breaching of the walls of Jerusalem before the destruction of the Second Temple"},{"date":"2025-07-26","title":"Rosh Chodesh Av","hebrew":"ראש חודש אב","category":"roshchodesh","description":"Start of month of Av on the Hebrew calendar. Av (אָב) is the 11th month of the civil Hebrew year (12th on leap years) and the 5th month of the biblical Hebrew year. It has 30 days and corresponds to July or August 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-08-02","title":"Shabbat Chazon","hebrew":"שבת חזון","subcat":"shabbat","category":"holiday","description":"Shabbat of Prophecy/Shabbat of Vision. Shabbat before Tish’a B’Av"},{"date":"2025-08-02","title":"Erev Tish’a B’Av","hebrew":"ערב תשעה באב","subcat":"major","category":"holiday","description":"The Ninth of Av. Fast commemorating the destruction of the two Temples"},{"date":"2025-08-03","title":"Tish’a B’Av","hebrew":"תשעה באב","subcat":"major","category":"holiday","description":"The Ninth of Av. Fast commemorating the destruction of the two Temples"},{"date":"2025-08-09","title":"Tu B’Av","hebrew":"ט״ו באב","subcat":"minor","category":"holiday","description":"Minor Jewish holiday of love. Observed on the 15th day of the Hebrew month of Av"},{"date":"2025-08-09","title":"Shabbat Nachamu","hebrew":"שבת נחמו","subcat":"shabbat","category":"holiday","description":"Shabbat after Tish’a B’Av (Shabbat of Consolation). The first of seven Shabbatot leading up to Rosh Hashanah. Named after the Haftarah (from Isaiah 40) which begins with the verse נַחֲמוּ נַחֲמוּ, עַמִּי (“Comfort, oh comfort my people”)"},{"date":"2025-08-24","title":"Rosh Chodesh Elul","hebrew":"ראש חודש אלול","category":"roshchodesh","description":"Start of month of Elul on the Hebrew calendar. Elul (אֱלוּל) is the 12th month of the civil Hebrew year (13th on leap years) and the 6th month of the biblical Hebrew year. It has 29 days and corresponds to August or September 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-08-25","title":"Rosh Hashana LaBehemot","hebrew":"ראש השנה למעשר בהמה","subcat":"minor","category":"holiday","description":"New Year for Tithing Animals"},{"date":"2025-08-25","title":"Rosh Chodesh Elul","hebrew":"ראש חודש אלול","category":"roshchodesh","description":"Start of month of Elul on the Hebrew calendar. Elul (אֱלוּל) is the 12th month of the civil Hebrew year (13th on leap years) and the 6th month of the biblical Hebrew year. It has 29 days and corresponds to August or September 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-09-13","title":"Leil Selichot","hebrew":"סליחות","subcat":"minor","category":"holiday","description":"Prayers for forgiveness in preparation for the High Holidays"},{"date":"2025-09-22","title":"Erev Rosh Hashana","hebrew":"ערב ראש השנה","subcat":"major","category":"holiday","description":"The Jewish New Year. Also spelled Rosh Hashanah"},{"date":"2025-09-23","title":"Rosh Hashana 5786","hebrew":"ראש השנה 5786","subcat":"major","category":"holiday","description":"The Jewish New Year. Also spelled Rosh Hashanah"},{"date":"2025-09-24","title":"Rosh Hashana II","hebrew":"ראש השנה ב׳","subcat":"major","category":"holiday","description":"The Jewish New Year. Also spelled Rosh Hashanah"},{"date":"2025-09-25","title":"Tzom Gedaliah","hebrew":"צום גדליה","subcat":"fast","category":"holiday","description":"Fast of the Seventh Month. Commemorates the assassination of the Jewish governor of Judah"},{"date":"2025-09-27","title":"Shabbat Shuva","hebrew":"שבת שובה","subcat":"shabbat","category":"holiday","description":"Shabbat of Returning. Shabbat that occurs during the Ten Days of Repentance between Rosh Hashanah and Yom Kippur"},{"date":"2025-10-01","title":"Erev Yom Kippur","hebrew":"ערב יום כיפור","subcat":"major","category":"holiday","description":"Evening of Yom Kippur (Day of Atonement), which includes the Kol Nidre service. The Yom Kippur fast begins at sundown and continues for 25 hours"},{"date":"2025-10-02","title":"Yom Kippur","hebrew":"יום כיפור","subcat":"major","category":"holiday","description":"Day of Atonement. The holiest day of the year in Judaism, traditionally observed with a 25-hour period of fasting and intensive prayer"},{"date":"2025-10-06","title":"Erev Sukkot","hebrew":"ערב סוכות","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-07","title":"Sukkot I","hebrew":"סוכות א׳","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-08","title":"Sukkot II","hebrew":"סוכות ב׳","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-09","title":"Sukkot III (CH’’M)","hebrew":"סוכות ג׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-10","title":"Sukkot IV (CH’’M)","hebrew":"סוכות ד׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-11","title":"Sukkot V (CH’’M)","hebrew":"סוכות ה׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-12","title":"Sukkot VI (CH’’M)","hebrew":"סוכות ו׳ (חוה״מ)","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-13","title":"Sukkot VII (Hoshana Raba)","hebrew":"סוכות ז׳ (הושענא רבה)","subcat":"major","category":"holiday","description":"Feast of Booths. Also called the Feast of Tabernacles, the seven-day holiday is one of the Three Pilgrimage Festivals (Hebrew: שלוש רגלים, shalosh regalim)"},{"date":"2025-10-14","title":"Shmini Atzeret","hebrew":"שמיני עצרת","subcat":"major","category":"holiday","description":"Eighth Day of Assembly. Immediately following Sukkot, it is observed as a separate holiday in the Diaspora and is combined with Simchat Torah in Israel"},{"date":"2025-10-15","title":"Simchat Torah","hebrew":"שמחת תורה","subcat":"major","category":"holiday","description":"Day of Celebrating the Torah. Celebration marking the conclusion of the annual cycle of public Torah readings, and the beginning of a new cycle"},{"date":"2025-10-22","title":"Rosh Chodesh Cheshvan","hebrew":"ראש חודש חשון","category":"roshchodesh","description":"Start of month of Cheshvan on the Hebrew calendar. חֶשְׁוָן (transliterated Cheshvan or Heshvan) is the 2nd month of the civil Hebrew year and the 8th month of the biblical Hebrew year. It has 29 or 30 days and corresponds to October or November 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-10-23","title":"Rosh Chodesh Cheshvan","hebrew":"ראש חודש חשון","category":"roshchodesh","description":"Start of month of Cheshvan on the Hebrew calendar. חֶשְׁוָן (transliterated Cheshvan or Heshvan) is the 2nd month of the civil Hebrew year and the 8th month of the biblical Hebrew year. It has 29 or 30 days and corresponds to October or November 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-11-20","title":"Sigd","hebrew":"חג הסיגד","subcat":"modern","category":"holiday","description":"Ethiopian Jewish holiday occurring 50 days after Yom Kippur"},{"date":"2025-11-21","title":"Rosh Chodesh Kislev","hebrew":"ראש חודש כסלו","category":"roshchodesh","description":"Start of month of Kislev on the Hebrew calendar. Kislev (כִּסְלֵו) is the 3rd month of the civil Hebrew year and the 9th month of the biblical Hebrew year. It has 30 or 29 days and corresponds to November or December 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-12-14","title":"Chanukah: 1 Candle","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-12-15","title":"Chanukah: 2 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-12-16","title":"Chanukah: 3 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-12-17","title":"Chanukah: 4 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-12-18","title":"Chanukah: 5 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-12-19","title":"Chanukah: 6 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-12-20","title":"Chag HaBanot","hebrew":"חג הבנות","subcat":"minor","category":"holiday","description":"North African Chanukah festival of daughters. Called Eid al-Banat in Arabic, the holiday was most preserved in Tunisia"},{"date":"2025-12-20","title":"Chanukah: 7 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-12-20","title":"Rosh Chodesh Tevet","hebrew":"ראש חודש טבת","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-12-21","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-12-21","title":"Rosh Chodesh Tevet","hebrew":"ראש חודש טבת","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-12-22","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-12-30","title":"Asara B’Tevet","hebrew":"עשרה בטבת","subcat":"fast","category":"holiday","description":"Fast commemorating the siege of Jerusalem"}]},"meta":{"timestamp":"2026-06-01T16:22:55.810Z","request_id":"dd9653dc-4f06-4290-96e8-6eb6d4b1c191"},"status":"ok","message":"Holidays retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/shabbat":{"get":{"operationId":"get_v1_shabbat","tags":["Jewish Calendar"],"summary":"Candle-lighting, parashah & Havdalah","description":"","parameters":[{"name":"geonameid","in":"query","required":false,"description":"A GeoNames id","schema":{"type":"string"},"example":"281184"},{"name":"lat","in":"query","required":false,"description":"Latitude (with lon + tzid)","schema":{"type":"string"}},{"name":"lon","in":"query","required":false,"description":"Longitude (with lat + tzid)","schema":{"type":"string"}},{"name":"tzid","in":"query","required":false,"description":"IANA timezone (with lat/lon)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"items":[{"date":"2026-06-05T19:01:00+03:00","title":"Candle lighting: 19:01","category":"candles"},{"date":"2026-06-06","title":"Parashat Sh’lach","category":"parashat"},{"date":"2026-06-06T20:24:00+03:00","title":"Havdalah: 20:24","category":"havdalah"}],"havdalah":{"title":"Havdalah: 20:24","datetime":"2026-06-06T20:24:00+03:00"},"location":"Jerusalem, Israel","parashah":{"date":"2026-06-06","title":"Parashat Sh’lach","hebrew":"פרשת שלח־לך"},"candle_lighting":{"title":"Candle lighting: 19:01","datetime":"2026-06-05T19:01:00+03:00"}},"meta":{"timestamp":"2026-06-01T16:22:55.965Z","request_id":"017d5b8a-2b3d-4a48-a309-a5b719915d51"},"status":"ok","message":"Shabbat times retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue, months & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Hebcal is the Jewish calendar as an API. /v1/convert?gy=2025&gm=6&gd=1 converts a Gregorian date to the Hebrew calendar (returning the Hebrew year, month, day, the formatted Hebrew date and any Jewish events that day); or /v1/convert?hy=5785&hm=Sivan&hd=5 converts a Hebrew date back to Gregorian (hm accepts a Hebrew month name — Nisan, Iyyar, Sivan, … Adar1/Adar2 — or a number). /v1/holidays?year=2025 lists the Jewish holidays of a year (major and minor, plus rosh chodesh and special shabbatot), each with its English and Hebrew title, date and category; add month=6 to scope to one Gregorian month. /v1/shabbat?geonameid=281184 gives this week's Shabbat candle-lighting time, Torah portion (parashah) and Havdalah time for a location — pass a GeoNames id, or latitude + longitude + tzid (e.g. lat=40.7&lon=-74.0&tzid=America/New_York). Data from Hebcal (CC-BY 4.0 / GPL). A Jewish-calendar resource — distinct from secular public-holiday and Islamic prayer-time APIs. Ideal for calendar, scheduling, religious and cultural applications.","source":"Hebcal — Jewish Calendar (hebcal.com)","endpoints":["/v1/convert","/v1/holidays","/v1/shabbat","/v1/meta"],"hebrew_months":["Nisan","Iyyar","Sivan","Tamuz","Av","Elul","Tishrei","Cheshvan","Kislev","Tevet","Shvat","Adar","Adar1","Adar2"]},"meta":{"timestamp":"2026-06-01T16:22:56.068Z","request_id":"3a740a32-ec9f-4321-9233-e961c103995b"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2900,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":745,"monthly_call_quota":57000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2330,"monthly_call_quota":265000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6080,"monthly_call_quota":930000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hebcal-api"}