POST/v1/astro/sade-sati
Sade Sati periods
Calculate all Sade Sati periods for a natal chart. Returns rising, peak, and setting phases for each period (first entry, final exit and every stay of Saturn in the sign, so retrograde re-entries are shown), current active status and phase from Saturn's sign on the check date, intensity score (0-100 scale, 40-90 while active), intensity label, and next upcoming period. Optionally check status for a specific date using check_date. Sade Sati is Saturn's 7.5-year transit over natal Moon sign and adjacent signs. Small Panoti (Dhaiya) covers Saturn in the 4th or 8th sign from natal Moon (~2.5 years each). Returns all past, current, and future Sade Sati cycles with phase descriptions.
Request parameters
locationoptional
string | null
City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
nameoptional
string
Person name associated with the birth record
daterequired
string
Birth date in YYYY-MM-DD format
timeoptional
string | null
Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudeoptional
number | null
Latitude. Required if location not provided.
longitudeoptional
number | null
Longitude. Required if location not provided.
timezoneoptional
string | null
IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
utc_offsetoptional
string | null
Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset
timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.ayanamsaoptional
string
Sidereal ayanamsa mode used in calculations
check_dateoptional
string | null
Date to check Sade Sati status. Defaults to today. Format: YYYY-MM-DD
Response fields
success
boolean
True if the request succeeded
message
string
Human-readable status message
data
object
data.birth_time_provided
boolean
True when a birth time was supplied. False when it was not: house, Ascendant and Moon-dependent results then carry the accuracy limits of an unknown birth time.
data.natal_moon_sign
string
data.natal_moon_sign_index
integer
data.sade_sati_signs
object
data.is_currently_active
boolean | null
Saturn is in the 12th, 1st or 2nd sign from the natal Moon on the check date.
data.current_phase
string | null
rising, peak or setting: the phase of Saturn's sign on the check date.
data.current_phase_description
string | null
data.intensity_score
integer | null
0-100 scale: rising 40 to 80, peak 70 to 90 (highest mid-phase), setting 80 to 40, by progress through the phase; 0 when not active.
data.intensity_label
string | null
high (70+), moderate (40-69) or low.
data.next_sade_sati
object | null
When not active: the next date Saturn enters one of the three signs, with its phase (rising for a new cycle; the resumed phase after a retrograde gap) and years away.
data.all_periods
array[SadeSatiPeriod] | null
Every Sade Sati cycle that begins between 10 years before birth and 50 years after the check date, each to its final exit from the 2nd sign (a cycle under way at the start of that range is left out).
data.small_panoti
array[object]
Every Small Panoti in the same range, each to Saturn's final exit from the sign.
data.small_panoti[].panoti_number
integer
data.small_panoti[].sign_index
integer
data.small_panoti[].sign
string
data.small_panoti[].position_from_moon
integer
data.small_panoti[].start
string
Saturn's first entry into the sign.
data.small_panoti[].end
string
Saturn's final exit from the sign, after any retrograde return.
data.small_panoti[].is_currently_active
boolean
Saturn is in this sign on the check date.
data.small_panoti[].duration_years
number
data.small_panoti[].segments
array[object]
Every stay of Saturn in the sign; more than one when it retrogrades out and back in.
data.small_panoti[].segments[].start
string
Date Saturn entered the sign (YYYY-MM-DD, UTC).
data.small_panoti[].segments[].end
string
Date Saturn left the sign (YYYY-MM-DD, UTC).
data.small_panoti[].is_interrupted
boolean | null
True when Saturn left the sign and came back (more than one segment).
data.is_small_panoti_active
boolean | null
data.current_small_panoti_position
integer | null
4 or 8 when Small Panoti is active (natal Moon reference)
data.mitigated_by_own_sign
boolean | null
data.mitigated_by_exaltation
boolean | null
Errors
Invalid API key format.
API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.
The provided API key was not found. Verify the key in your Asterwise dashboard.
This API key has been revoked.
Too many requests per minute. Please slow down.
Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.
Too many requests from this IP address. Please slow down.
Monthly API call limit reached. Upgrade your plan to continue.
Request body exceeds maximum allowed size of 64KB.
Your subscription has expired. Please renew at asterwise.com/dashboard to continue.
The request couldn't be processed. See the 'details' field for specific field-level issues.