{"openapi":"3.0.3","info":{"title":"SimplyAstro open astronomy and festival data API","version":"1.0.0","description":"Free read-only JSON API. Data is computed from the NASA JPL DE421 ephemeris and licensed CC BY 4.0. Attribute SimplyAstro (https://simplyastro.com).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://simplyastro.com/api/v1"}],"paths":{"/festivals":{"get":{"summary":"List of 2026 festival dates","parameters":[],"responses":{"200":{"description":"JSON"}}}},"/festival-times/{kind}/{country}/{region}":{"get":{"summary":"Moonrise, sunset or Pradosh Kaal for a state or region","parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"},"description":"karwa-chauth-moonrise, sharad-purnima-moonrise, diwali-lakshmi-puja-time, dhanteras-puja-time or chhath-arghya-time"},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"country slug, e.g. india"},{"name":"region","in":"path","required":true,"schema":{"type":"string"},"description":"region slug, e.g. uttar-pradesh"}],"responses":{"200":{"description":"JSON"}}}},"/retrogrades/{planet}":{"get":{"summary":"Retrograde periods and sign changes 2026 to 2028","parameters":[{"name":"planet","in":"path","required":true,"schema":{"type":"string"},"description":"mercury to pluto"}],"responses":{"200":{"description":"JSON"}}}},"/seasons/{year}":{"get":{"summary":"Zodiac season start times (Sun ingress) for 2026 to 2028","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string"},"description":"2026, 2027 or 2028"}],"responses":{"200":{"description":"JSON"}}}},"/tithi":{"get":{"summary":"Lunar day (tithi) for a date and IST time","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string"},"description":"YYYY-MM-DD"},{"name":"time","in":"query","required":false,"schema":{"type":"string"},"description":"HH:MM IST, default 12:00"}],"responses":{"200":{"description":"JSON"}}}},"/jupiter-return":{"get":{"summary":"Jupiter return dates from a birth date","parameters":[{"name":"dob","in":"query","required":true,"schema":{"type":"string"},"description":"YYYY-MM-DD"}],"responses":{"200":{"description":"JSON"}}}}}}