POST · VEDIC

Kalsarpa Report

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

Combines computed Kalsarpa Yoga analysis with pre-written multilingual interpretation text. Detects all 12 types of Kalsarpa Yoga (Anant through Sheshnag), identifies Savya/Apasavya direction, and returns planet arc distribution, effects, interpretation, and remedies.

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, −90…90.
longitudenumberYesDecimal degrees, −180…180.
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.

Response shape

kalsarpa object

FieldTypeDescription
has_kalsarpabooleantrue if full Kalsarpa Yoga is formed.
is_partialbooleantrue if a partial formation is detected (conjunction breaks axis).
typeobject | nullKalsarpa type details when detected: name, rahu_house, ketu_house.
type_namestring | nullType name (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachur, Ghatak, Vishdhar, Sheshnag).
directionstring | null"savya" (clockwise) or "apasavya" (anti-clockwise).
direction_sanskritstring | nullSanskrit name for direction.
rahuobjectRahu position: house, sign, longitude. Always populated.
ketuobjectKetu position: house, sign, longitude. Always populated.
planets_in_rahu_to_ketu_arcarrayPlanet names in the Rahu→Ketu arc.
planets_in_ketu_to_rahu_arcarrayPlanet names in the Ketu→Rahu arc.
planets_conjunct_rahuarrayPlanets conjunct Rahu (breaking the axis).
planets_conjunct_ketuarrayPlanets conjunct Ketu (breaking the axis).
effectsarrayEffect descriptions when Kalsarpa is present; empty otherwise.

interpretation & remedy objects

FieldTypeDescription
titlestringSection title.
textstringDetailed interpretation paragraph.
keywordsarraySummary keyword strings.

12 Kalsarpa types

Rahu HouseType Name
1Anant
2Kulik
3Vasuki
4Shankhpal
5Padma
6Mahapadma
7Takshak
8Karkotak
9Shankhachur
10Ghatak
11Vishdhar
12Sheshnag

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent or not numeric.
400INVALID_DATEYear out of range or bad calendar date.
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 computation failed.

Notes

  • rahu and ketu positions are always populated, regardless of whether Kalsarpa is detected.
  • Arc distribution (planets_in_rahu_to_ketu_arc / planets_in_ketu_to_rahu_arc) is always computed.
  • Interpretation text adapts: not present, partial, or type-specific text for each of the 12 types.
  • Remedy text is always returned (general Kalsarpa remedies applicable to all types).

See also