POST · VEDIC

Kalsarpa Analysis

Endpoint POST https://starsapi.com/api/v3/vedic/yogas-doshas/kalsarpa-analysis

Returns the full Kalsarpa Yoga analysis — Rahu/Ketu positions, planet distribution across the two arcs of the nodal axis, node conjunctions with orb, type, direction, and interpretive description.

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.

Response shape

FieldTypeDescription
has_kalsarpa / is_partialbooleanVerdict flags.
type / type_namestring|nullMachine key and classical name (by Rahu’s house).
direction / direction_sanskritstring|nullAxis direction.
rahu / ketuobjecthouse, sign, longitude.
planets_in_rahu_to_ketu_arcarrayPlanets in the Rahu→Ketu arc.
planets_in_ketu_to_rahu_arcarrayPlanets in the Ketu→Rahu arc.
planets_conjunct_rahu / planets_conjunct_ketuarrayPlanets within the conjunction orb of each node.
conjunction_orbnumberOrb in degrees used for node conjunctions.
descriptionstringInterpretation.
effectsarrayEffects when present.

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