POST · VEDIC

Sade Sati Details

Endpoint POST https://starsapi.com/api/v3/vedic/yogas-doshas/sade-sati-details

Returns the structural details of Sade Sati for the chart — the three transit signs (rising/peak/setting), current Saturn position with ingress/egress dates, and the current status block.

Authentication

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Query?api_key=am_live_xxxxxxxxxxxx

Request body

FieldTypeRequiredDescription
namestringNoEchoed in the response.
genderstringNomale or female — used by gender-specific yoga rules.
yearintegerYesBirth year.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.
reference_datestringNoDate to evaluate (YYYY-MM-DD). Default: today.

Response shape

FieldTypeDescription
moon_signobjectNatal Moon sign.
sade_sati_signsobjectrising_12th, peak_1st, setting_2nd — the three signs Saturn crosses.
current_saturnobjectSign, motion (Direct/Retrograde), and sign ingress/egress dates.
current_statusobjectActive flag with current phase block.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEHour/minute/second out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
400INVALID_PARAMBad ayanamsa or node_type.
405METHOD_NOT_ALLOWEDNon-POST request.

See also