That strategy would work almost all of the time, but not quite all of the time.

For example, on Friday September 11, 2026 is Erev Rosh Hashana. You'll have a candles event that day.

Saturday, September 12, 2025 is Rosh Hashana 5787 and that evening is the 2nd erev. Although it's Saturday night, there will NOT be a havdalah event. Instead, you will have yet another candles event on Saturday night. (and then you'll have a havdalah event on Sunday night September 13 when the 2nd day of RH concludes.

The only web API that we have that shows the upcoming Shabbat's parasha haShavua every single day of the week is the Hebrew Date Converter REST API.

From the URL you posted, it looks like you are hoping to use the Jewish calendar REST API. Unfortunately, this API does not support looking up the weekly Torah portion every day of the week.

If you wish to use the Jewish calendar REST API to look up the weekly Torah portion, you will need to specify the date of Shabbat (for example, this week 2024-03-15) and not today's day.

You can also use the Leyning (Torah Reading) API to get the full kriyah leyning on Shabbat and holidays, Triennial (optionally) for Shabbat, and weekday readings on Mondays & Thursdays. However, this API would not return the weekly Torah portion on a Tuesday because there is no Torah reading on a typical Tuesday.

If you don't want to wait until Saturday at midnight local time, you can always specify an exact date. The documentation describes this as follows:

You can optionally specify an exact date, for example 13 February 2021. If unspecified, defaults to today.

• gy=2021&gm=2&gd=13

Typically doesn't mean definitely. If the Shabbat is not a regular parsha because it's a holiday instead, you will not find a parashat category present.

Sorry the docs are confusing!

Thanks for the bug report! This issue is now fixed.

Thanks for contacting Hebcal.

The time format on the Hebcal.com website is specific to a location. Some countries such as Israel use 24 hour format. Other locations like the United States, Canada or Brazil use a 12 hour format.

If you wish to have more control over how Hebcal events are displayed, we would encourage you to download the Hebcal events to another application (Google Calendar, Apple Calendar, Microsoft Outlook, etc.) and then format the calendar as you see fit.

https://www.hebcal.com/home/38/printing-a-jewish-calendar

Pages generated by the Interactive Jewish Calendar can be printed very easily on standard 8.5×11″ paper. Just try “Print Preview” and you’ll see what it looks like. You can print out an entire year at a time and each month will end up on a separate sheet.

We also offer a simple Print PDF feature that creates PDF files in landscape layout, one page per month.

To print other sizes or to customize, we recommend downloading/exporting from hebcal.com and importing into a more full-featured desktop or web calendar program, such as one of the following:

• Outlook CSV – Outlook has extremely powerful print features (Daily, Weekly, Monthly, Tri-fold, Calendar Details, Day-Timer, Day Runner, Franklin Day Planner, etc.)
• Google Calendar – offers Day, Week, Month, or Agenda views with customizable date range, font size, page orientation, and color setting (see also “Print your calendar” from Google support)
• Apple macOS Calendar – offers Day, Week, Month, List, Selected Events in US Letter and other standard paper formats. Options include All-day events, Timed events, Color/Black and white, and text size controls.

See the Printable Shabbat Times tool to print out candle lighting times only for an entire year.

Calendars in printed form are provided with a Creative Commons Attribution 4.0 license. This means that you are free to use, copy and redistribute the material in any medium or format as long as you give appropriate credit to Hebcal.com.

Yes, look at the events array

https://www.hebcal.com/converter?gd=11&gm=3&gy=2025&g2h=1&cfg=json&lg=he-x-NoNikud

You'll see something like this:

{
  "gy": 2025,
  "gm": 3,
  "gd": 11,
  "afterSunset": false,
  "hy": 5785,
  "hm": "Adar",
  "hd": 11,
  "hebrew": "י״א בַּאֲדָר תשפ״ה",
  "heDateParts": {
    "y": "תשפ״ה",
    "m": "אדר",
    "d": "י״א"
  },
  "events": [
    "פרשת כי תשא"
  ]
}

We've completed this change. "Show Hebrew date for dates with some event" shows for any event type except for a daily learning event.

Thanks for this feedback. We will investigate and consider changing exactly as you suggest

Weekly calculations change every Sunday at midnight in the city’s local time zone.

The returned JSON results includes a list of items that have a category will typically include each of the following:

• candles – Candle-lighting on Friday or erev chag
• parashat – Parashat HaShavua, the weekly Torah portion
• havdalah – Havdalah, the end of Shabbat

Depending on the week of the year, other items may appear in the results, including

• holiday (with subcat major or minor or fast)
• zmanim (often with subcat fast for “Fast begins” or “Fast ends”)

This API uses a similar URL and response format as our full Jewish calendar REST API, but offers less control over the dates and times. If you find you want more fine-grained control over the date ranges, or what kinds of events are included and which are excluded, we recommend using the full Jewish calendar REST API instead.