Shabbat Times Widget and API for Synagogues

Pick your city, copy the line of code and paste it into a page of your site. The widget shows candle lighting, Havdalah and the Torah portion of the next Shabbat, recalculated every day, light or dark to match the device.

Preview

Code to copy

<iframe src="https://moedcal.com/widget-frame/en/new-york/" title="Shabbat times" width="360" height="190" style="border:0;max-width:100%" loading="lazy"></iframe>

Attribution

The widget carries a fixed “Times: Moed” link to moedcal.com, which must not be removed. The API data is under a CC BY 4.0 license: credit “Times: Moed” with a link to moedcal.com.

The JSON API

Free, no key, read-only. Times are in local format (HH:MM, 24 h) with the full ISO instant. Please keep to one request a second and cache responses for an hour.

GET https://moedcal.com/api/v1/shabbat/?city=new-york

The next Shabbat: candle lighting, Havdalah, Rabbeinu Tam, Torah portion, haftarah. Optional parameter: date=YYYY-MM-DD.

GET https://moedcal.com/api/v1/zmanim/?city=new-york&date=2026-10-16

The zmanim of a day: each time with its rounding direction.

GET https://moedcal.com/api/ical/fetes/?year=2027&lang=en

The holidays and fasts of a year, as .ics (all-day events).

Cities are identified by their address: paris, marseille, london, new-york, jerusalem… A city’s address is the address of its page on the site.

An example response

{
  "city": {
    "slug": "new-york",
    "name": {
      "he": "ניו יורק",
      "fr": "New York",
      "en": "New York"
    },
    "country": "US",
    "timezone": "America/New_York",
    "calendar": "diaspora"
  },
  "friday": "2026-10-16",
  "saturday": "2026-10-17",
  "candleLighting": {
    "time": "17:56",
    "iso": "2026-10-16T17:56:00-04:00",
    "minutesBeforeSunset": 18
  },
  "havdalah": {
    "time": "18:54",
    "iso": "2026-10-17T18:54:00-04:00"
  },
  "…": ""
}

iCal

The holidays of the year can be downloaded on each calendar page; a city’s Shabbatot on its “All Shabbat times” page. The files update themselves in your calendar.

These times on your iPhone

The same times in the app, for you and your congregation: free, no ads.

Free, with no ads and no in-app purchases.
Your data stays on your phone.

Shabbat times widget and API

The widget to embed