POST · VEDIC

Sade Sati Report

Endpoint POST https://starsapi.com/api/v3/vedic/predictions/sade-sati-report

Combines computed Sade Sati analysis (current phase, timeline, Ashtakvarga severity, natal Saturn assessment) with pre-written multilingual interpretation, Moon-sign impact guide, and remedies. Detects rising, peak, and setting phases with progress percentages and days remaining.

Authentication

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

Request body

FieldTypeRequiredDescription
yearintegerYesBirth year, 1800–2400.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 0–23.
minuteintegerYesMinute, 0–59.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone identifier.
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.
languagestringNoDefault en. Supported: en, es, fr, pt, it, de, ru, hi, ta, te, kn, ml, bn.
reference_datestringNoYYYY-MM-DD. Default: today. The date to check Sade Sati status against.

Response shape

sade_sati object

FieldTypeDescription
moon_signobjectname, number, longitude.
current_statusobjectActive status, current phase, period dates, next/previous Sade Sati.
ashtakvarga_analysisobjectSaturn BAV points and SAV totals for the 3 transit signs, severity rating.
saturn_natal_assessmentobjectNatal Saturn strength: overall (highly_favorable/favorable/mixed/challenging), dignity, house, factors, summary.

current_phase (when active)

FieldTypeDescription
phasestringrising (12th from Moon), peak (over Moon), setting (2nd from Moon).
phase_numberinteger1, 2, or 3.
saturn_in_signstringCurrent Saturn transit sign.
start_date / end_datestringPhase date range (YYYY-MM-DD).
days_remaining_in_phaseintegerDays until this phase ends.
phase_progress_pctnumberPhase completion percentage.
overall_progress_pctnumberOverall 7.5-year progress percentage.

Interpretation blocks

Three text blocks returned, each with title, text, keywords:

FieldContent
interpretationPhase-specific text: not running, rising, peak, or setting.
remedyGeneral Sade Sati remedies.
moon_sign_impactHow severity varies by natal Moon sign.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEYear out of range, bad calendar date, or bad reference_date format.
400INVALID_TIMEHour or minute out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELatitude or longitude out of range.
400INVALID_PARAMBad node_type, ayanamsa, or language.
405METHOD_NOT_ALLOWEDNon-POST request.
500COMPUTE_ERRORChart or Sade Sati computation failed.

Notes

  • Ashtakvarga analysis evaluates Saturn’s BAV points in the 3 Sade Sati signs — higher points = milder transit.
  • saturn_natal_assessment checks natal Saturn’s dignity, house, yogakaraka status, and lordship to predict overall Sade Sati severity.
  • Use reference_date to check Sade Sati status for any past or future date.

See also