ZmanimPro JSON API

Rate Limits & Terms

• No API key or registration is required. Please keep request volume reasonable (cache responses for at least one hour).
• Responses are JSON over HTTPS. Times are ISO 8601 with the city's timezone offset.
• Data is calculated algorithmically from the Hebrew calendar and NOAA solar positions — the same engine as the website.

GET /api/shabbat/{city}

Returns this week's Shabbat times for one of the supported cities. Replace {city} with a city slug (see the city directory).

Example request:

curl https://zmanimpro.com/api/shabbat/jerusalem

Example response:

{
    "city": "Jerusalem",
    "friday": "2026-09-18",
    "candle_lighting": "2026-09-18T18:05:37+03:00",
    "sunset": "2026-09-18T18:45:37+03:00",
    "havdalah": "2026-09-19T19:56:18+03:00",
    "rabbeinu_tam": "2026-09-19T19:52:20+03:00",
    "parsha": "Ha'Azinu",
    "hebrew_date": "8 Tishrei, 5787"
}

Fields:

Field	Description
city	City display name
friday	Date of the upcoming Friday (Y-m-d)
candle_lighting	Candle-lighting time — sunset minus the city's customary offset (Jerusalem 40 min, most others 18)
sunset	Friday sunset
havdalah	Havdalah time — 72 minutes (Tzais 8.5°) after Saturday sunset
rabbeinu_tam	Rabbeinu Tam's nightfall — Tzais 16.1°
parsha	Weekly Torah portion (Ashkenazi transliteration)
hebrew_date	Hebrew date of the Shabbat

Unknown city slugs return {"error": "City not found"} with all other fields omitted.

GET /api/nearest?lat={lat}&lon={lon}

Returns the supported city nearest to the given coordinates (haversine distance over the city database). If the nearest supported city is more than 500 km away, an error: "too_far" response is returned instead.

Example request:

curl "https://zmanimpro.com/api/nearest?lat=31.78&lon=35.24"

Example response:

{
    "city_slug": "jerusalem",
    "city_name": "Jerusalem",
    "distance_km": 0.7
}

Invalid or missing coordinates return {"error": "Invalid coordinates"}. Combine with /api/shabbat/{city} to build location-aware integrations.

Attribution

If you build something with this API, a link to ZmanimPro is appreciated. See How Zmanim Are Calculated for the underlying algorithms (NOAA solar calculations, the KosherJava calendar model) and About for methodology notes.