Posted by & filed under Developers, APIs, RSS Feeds, Source Code. offers a REST API for fetching Jewish calendar data. The output format is in JSON.

The basic URL format is as follows:

Note the following customizable parameters and their meanings:

  • v=1 – version. Required.
  • cfg=json – output JSON instead of HTML. Also variant cfg=fc for integration
  • year=now – “now” for current year, or 4-digit YYYY such as 2003
  • month=x – “x” for entire Gregorian year, or use a numeric month (1=January, 6=June, etc.)
  • maj=on – Major holidays
  • min=on – Minor holidays (Tu BiShvat, Lag B’Omer, …)
  • nx=on – Rosh Chodesh
  • mf=on – Minor fasts (Ta’anit Esther, Tzom Gedaliah, …)
  • ss=on – Special Shabbatot (Shabbat Shekalim, Zachor, …)
  • mod=on – Modern holidays (Yom HaShoah, Yom HaAtzma’ut, …)
  • s=on – Parashat ha-Shavuah on Saturday
  • c=on – Candle lighting times. See also candle-lighting options below.
    • m=50 – Havdalah 50 minutes after sundown. Set to m=0 (zero) to disable Havdalah times
    • b=18 – Candle-lighting time minutes before sunset
  • D=on – Hebrew date for dates with some event
  • d=on – Hebrew date for entire date range
  • o=on – Days of the Omer

Mutually exclusive options for Diaspora/Israel holidays and Torah Readings:

  • i=off – Diaspora holidays and Torah readings (default if unspecified)
  • i=on – Israel holidays and Torah readings

Mutually exclusive location for candle-lighting times:

  • geo=none – no candle-lighting location (default if unspecified)
  • geo=geoname – location specified by numeric ID
    • requires additional parameter geonameid=3448439
    • supports approximately 47,000 different GeoNames IDs. These are cities with a population of 5000+. See from
  • geo=zip – location specified by United States ZIP code
    • requires additional parameter zip=90210
  • geo=city – location specified by one of the legacy city identifiers
    • requires additional parameter city=GB-London
  • geo=pos – location specified by latitude, longitude, and timezone. Requires additional 7 parameters:
    • ladeg=[0-90] – latitude degrees
    • lamin=[0-60] – latitude minutes
    • ladir={n,s} – latitude direction (North or South)
    • lodeg=[0-180] – longitude degrees
    • lomin=[0-60] -longitude minutes
    • lodir={e,w} -longitude direction (East or West)
    • tzid=TimezoneIdentifier (See List of tz database time zones)

Mutually exclusive language parameter:

  • lg=s – Sephardic transliterations (default if unspecified)
  • lg=sh – Sephardic translit. + Hebrew
  • lg=a – Ashkenazis transliterations
  • lg=ah – Ashkenazis translit. + Hebrew
  • lg=h – Hebrew only

Optional callback parameter:

  • callback=function – wraps the JSON output text in parentheses and a function name of your choosing. Callback function names may only use upper and lowercase alphabetic characters (A-Z, a-z), numbers (0-9), the period (.), the underscore (_).

And example output looks like this:

    "link": ";nx=on;year=2015;month=5;ss=on;mf=on;c=on;geo=geoname;geonameid=3448439;m=50;s=on;maj=on;min=on;mod=on",
    "title": "Hebcal May 2015 São Paulo, Brazil",
    "date": "2014-11-30T06:53:48-00:00",
    "location": {
        "geonameid": 3448439,
        "latitude": -23.5475,
        "tzid": "America/Sao_Paulo",
        "geo": "geoname",
        "title": "São Paulo, Brazil",
        "city": "São Paulo",
        "longitude": -46.63611
    "items": [{
        "category": "candles",
        "title": "Candle lighting: 5:11pm",
        "date": "2015-05-22T17:11:00-03:00"
    }, {
        "date": "2015-05-23",
        "hebrew": "פרשת במדבר",
        "title": "Parashat Bamidbar",
        "link": "",
        "category": "parashat",
        "leyning": {
            "torah":"Numbers 1:1 - 4:20",
            "haftarah":"Hosea 2:1 - 2:22"
    }, {
        "category": "holiday",
        "link": "",
        "hebrew": "ערב שבועות",
        "date": "2015-05-23",
        "title": "Erev Shavuot"
    }, {
        "date": "2015-05-23T18:19:00-03:00",
        "title": "Candle lighting: 6:19pm",
        "category": "candles"
    }, {
        "link": "",
        "hebrew": "שבועות יום א׳",
        "date": "2015-05-24",
        "title": "Shavuot I",
        "yomtov": true,
        "category": "holiday"
    }, {
        "category": "holiday",
        "yomtov": true,
        "title": "Shavuot II",
        "hebrew": "שבועות יום ב׳",
        "date": "2015-05-25",
        "link": ""
    }, {
        "category": "havdalah",
        "title": "Havdalah (50 min): 6:18pm",
        "date": "2015-05-25T18:18:00-03:00"

If you don’t want candle lighting times, just use c=off and omit the zip and m parameters.

Posted by & filed under Download - BlackBerry.

We’re pleased to offer Jewish holiday downloads for BlackBerry devices through a two step process that sends Hebcal data first to Google Calendar, and then to your BlackBerry.

Note that Hebcal is not an app for BlackBerry (in the BlackBerry App World sense of apps that you install). Rather, Hebcal is a website that allows you to download/export calendar data to the calendar application that comes natively with your device.

1. Follow our Google Calendar Jewish holidays download instructions.

2. Then, follow these instructions depending on whether you use the Google Apps for Work (enterprise) + BB10 or regular Google + BB5, BB6 or BB7:

Google Apps for Work users use Google Sync for BlackBerry, which uses ActiveSync to sync with Google Apps. See Set Up Google Sync for BlackBerry 10 for more details.

Non-enterprise Google users with BlackBerry 5, 6, or 7 can use BlackBerry® Internet Service (BIS), which is part of the standard BlackBerry service plan to sync Gmail, Google Calendar, and Contacts with their BlackBerry. BIS is provided by RIM and mobile carriers. BlackBerry offers this guidance on syncing Calendar. Please contact RIM or your carrier for more information and support.

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to (previously called Windows Live Calendar).

  1. Go to if you’re downloading a holiday calendar, or if you’re downloading a Yahrzeit + Anniversary calendar.
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
  4. Select the option from the Download dialog box, and click on Download to Calendar button.
    Hebcal download dialog Outlook Windows Live Calendar
  5. When you get to the page, select a calendar color and an optional Charm, then click Subscribe:
    Outlook Windows Live Calendar_-_Import_or_Subscribe v2

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).

Posted by & filed under General.

Feel free to make printed calendars, email newsletters, refrigerator magnets, and other content using events from

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution 3.0 License.

Among other things, this license gives you permission to remix, transform, and build upon the material for any purpose, even commercially. You must give appropriate credit to, but beyond that you need not send us money or even explicitly ask us for permission.


Posted by & filed under Download - Apple Mac OS X iCal, Download - removal.

Follow these steps to remove Hebcal events from your Mac Desktop calendar or iCloud calendar and you didn’t use the Subscription feature.

(If you subscribed to a Hebcal in Apple iCal on Mac OS X, follow our delete/unsubscribe from Mac Calendar (iCal) instructions.)

1. Open Mac Calendar, and uncheck all calendars except for the one that contains Hebcal events.


2. In the search box on the upper-right, type the text “hebcal” and press Return to select Events that contain “hebcal”


3. Click on the first item in the search results pane on the right. Scroll to the bottom, and holding down the Shift key, click on the last item in the search results pane on the right


4. Press the Delete key, or use the Edit Delete menu to remove the events.

Posted by & filed under Download - Microsoft Outlook, Download - removal.

To delete Hebcal events from Microsoft Outlook 2011 for Mac OS X, follow these steps.

1. First, open your Calendar within Outlook

2. Next, search for “hebcal” in the search box on the upper right



3. Click on one of the search results, then select all of the entries in the list via EditSelect All



4. Delete the entries via EditDelete

Posted by & filed under Download - General, Download - removal.

To make a change to a Yahrzeit + Anniversary calendar calendar, delete or unsubscribe from the calendar. Return to and re-enter in all of the event details, then download again. Hebcal does not yet support editing event dates.

To avoid storing sensitive user data on our servers, recently modified our Yahrzeit + Anniversary calendar export to “download” instead of “subscribe” calendars. This change affects Yahrzeit + Anniversary calendars created on Hebcal beginning in January 2014, and it applies across iOS, Mac Desktop, Microsoft Outlook, etc.

To make changes like adding a new Yahrzeit or removing one depends on when you downloaded your data from Hebcal.

  • If you “subscribed” to a Yahrzeit + Anniversary calendar (before Jan 2014), delete/unsubscribe from the calendar. Return to and re-enter in all of the data, then download again.
  • If you “downloaded” (Jan 2014 and later), then any Yahrzeit or Anniversary reminders are now part of your regular calendar (often called “Home” or “Calendar”). To add new events, just go to and create reminders and download again. To remove events, search for the event(s) in your regular calendar and simply remove them.

Note that this recent change does not apply to regular holiday calendars. Those still offer the “subscribe” functionality.

Posted by & filed under Candle lighting, News.

We’ve made changes to candle-lighting times for Shabbat and holidays that corrects an error we introduced a few months ago. Please accept our sincere apologies for this error.

Candle-lighting times have been adjusted 1-2 minutes earlier and now correctly reflect the correct time to light candles (40 minutes before sundown in Jerusalem, 18 minutes before sundown anywhere else).

Users who subscribe to calendars via iPhone/iPad, Google Calendar, or should get the corrected candle-lighting times automatically when these applications perform their next refresh. The typical refresh cycle is approximately once a week.

If you downloaded or printed a calendar in the past, you may wish to return to the website to download and/or print an updated calendar.

The error was caused when moved to a new sunset calculation engine in the summer of 2013. The new sunset engine allows support for thousands of global cities and fixed long-standing issues with our handling of Daylight Saving Time outside of the USA. Sunset times are estimated from latitude and longitude, and generally have an accuracy of +/- 2 minutes except at extreme north or south latitudes.

Unfortunately, an arithmetic error in determining sunset for a given latitude/longitude was inadvertently introduced, which added an additional 1-2 minutes of error. This error was recently discovered and corrected.

Posted by & filed under News.

We are pleased to announce that now supports Daf Yomi. Now you can use Hebcal to help follow your daily regimen of learning the Talmud!

For example, today’s Daf Yomi is Yoma 52.

Just check the new “Daf Yomi” checkbox on the “Include Events” section of our Custom Calendar. We’ve also posted a simple iCalendar feed for those of you who want to subscribe in Google Calendar or Apple Calendar and track the events with a separate color.

Many thanks to Aaron Peromsik for doing the work to add this feature.