{"openapi":"3.1.0","info":{"title":"Seder HaYom zmanim API","version":"1.0.0","description":"Zmanim from the Seder HaYom app’s own engine, by place, date and shita. Times are rounded to the stricter minute (`time`), with the unrounded value in `exact`. Read-only, no key. Not a halachic ruling.","contact":{"url":"https://sederhayom.app/developers"}},"servers":[{"url":"https://sederhayom.app"}],"paths":{"/api/v1/zmanim":{"get":{"operationId":"getZmanim","summary":"Zmanim for a place and a date (or up to 31 days)","parameters":[{"name":"place","in":"query","schema":{"type":"string"},"description":"Place slug, e.g. il-jerusalem. Or give lat, lon and tz."},{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"tz","in":"query","schema":{"type":"string"},"description":"IANA time zone, with lat/lon."},{"name":"elevation","in":"query","schema":{"type":"number","default":0}},{"name":"date","in":"query","schema":{"type":"string","format":"date"},"description":"Defaults to today at the place."},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}},{"name":"shita","in":"query","schema":{"type":"string","enum":["sunPosition","ashkenaziMga90","ashkenaziDiaspora","sefardiZmaniyot","teimani","chabad","ashkenaz-sun-position","ashkenaz-mga-90","ashkenaz-abroad","edot-hamizrach","teiman","chabad"],"description":"Shita id or slug; defaults by place (sunPosition in Israel, ashkenaziDiaspora abroad)."}},{"name":"region","in":"query","schema":{"type":"string","enum":["israel","diaspora"]},"description":"Holiday calendar; defaults by the place’s country."},{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}}],"responses":{"200":{"description":"One day (or `{ days: [...] }` with from/to)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Day"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/shabbat":{"get":{"operationId":"getShabbat","summary":"Candle lighting and Shabbat’s end for the coming weeks","parameters":[{"name":"place","in":"query","required":true,"schema":{"type":"string"}},{"name":"shita","in":"query","schema":{"type":"string","enum":["sunPosition","ashkenaziMga90","ashkenaziDiaspora","sefardiZmaniyot","teimani","chabad","ashkenaz-sun-position","ashkenaz-mga-90","ashkenaz-abroad","edot-hamizrach","teiman","chabad"],"description":"Shita id or slug; defaults by place (sunPosition in Israel, ashkenaziDiaspora abroad)."}},{"name":"weeks","in":"query","schema":{"type":"integer","minimum":1,"maximum":8,"default":1}},{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}}],"responses":{"200":{"description":"Weeks"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/next":{"get":{"operationId":"getNextZman","summary":"The next zman at a place and how many minutes away it is","parameters":[{"name":"place","in":"query","required":true,"schema":{"type":"string"}},{"name":"shita","in":"query","schema":{"type":"string","enum":["sunPosition","ashkenaziMga90","ashkenaziDiaspora","sefardiZmaniyot","teimani","chabad","ashkenaz-sun-position","ashkenaz-mga-90","ashkenaz-abroad","edot-hamizrach","teiman","chabad"],"description":"Shita id or slug; defaults by place (sunPosition in Israel, ashkenaziDiaspora abroad)."}},{"name":"now","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}}],"responses":{"200":{"description":"Next zman"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/places":{"get":{"operationId":"searchPlaces","summary":"Search places by English or Hebrew name (diacritic-insensitive)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"`{ places: [...] }`"}}}},"/api/v1/places/{slug}":{"get":{"operationId":"getPlace","summary":"One place record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}}],"responses":{"200":{"description":"Place"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/shitot":{"get":{"operationId":"listShitot","summary":"The six shitot with their configuration","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["he","en"],"default":"he"}}],"responses":{"200":{"description":"`{ shitot: [...] }`"}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["place_not_found","bad_date","range_too_long","bad_shita","bad_request","internal"]},"message":{"type":"string"}}}}},"Zman":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"time":{"type":"string","description":"Displayed minute with offset, e.g. 2027-11-19T16:02+02:00"},"exact":{"type":"string","description":"Unrounded, ISO 8601 to the ms"},"rounding":{"type":"string","enum":["earlier","later"]}}},"Day":{"type":"object","properties":{"place":{"type":"object"},"date":{"type":"string","format":"date"},"hebrewDate":{"type":["string","null"]},"parasha":{"type":["string","null"]},"holiday":{"type":["string","null"]},"region":{"type":"string","enum":["israel","diaspora"]},"shita":{"type":"object"},"zmanim":{"type":"array","items":{"$ref":"#/components/schemas/Zman"}},"method":{"type":"object"},"notes":{"type":"string"},"source":{"type":["string","null"]}}}}}}