Kalsarpa Dosha
Analyses a person's birth chart to detect and describe the Kalsarpa Dosha — a significant planetary affliction in Vedic astrology — based on their birth date, time, and geographic location.
What this API does
In Vedic astrology, Kalsarpa Dosha (also spelled Kaalsarpa) occurs when all seven classical planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, and Saturn) are hemmed between the lunar nodes Rahu and Ketu in the birth chart. This configuration is considered one of the most impactful doshas, believed to influence various aspects of a person's life including career, relationships, health, and spiritual growth.
This endpoint computes the planetary positions for the given birth data, determines whether Kalsarpa Dosha is present, identifies the specific type of Kalsarpa Dosha formed, and returns a detailed analysis of its nature and effects.
What data it returns
The API returns a structured JSON response containing:
- Dosha presence: Whether Kalsarpa Dosha is present or absent in the birth chart
- Dosha type: The specific named variant of Kalsarpa Dosha (e.g., Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhnaad, Patak, Vishdhar, Sheshnag), determined by the houses occupied by Rahu and Ketu
- Dosha direction: Whether it is a full (complete) or partial Kalsarpa Dosha, and the direction of the serpent (ascending or descending)
- Effects and description: A textual description of the dosha's influence on the native's life, covering areas such as career, wealth, relationships, and spiritual tendencies
- Remedial context: Contextual information about the severity and nature of the dosha to guide further astrological consultation
Main use cases
- Horoscope analysis platforms that provide automated dosha detection and interpretation as part of a full birth chart reading
- Astrology consultation tools where practitioners need a quick, accurate assessment of Kalsarpa Dosha before advising clients on remedies
- Kundali matching and compatibility services that factor in dosha presence when evaluating marriage compatibility
- Personal astrology apps offering users insight into significant planetary afflictions in their birth chart and their potential life impact
- Spiritual and wellness platforms that incorporate Vedic astrology to guide users on karmic patterns and life challenges
Key functionality
- Precise birth data input: Accepts day, month, year, hour, minute, second, and timezone offset to calculate exact planetary positions at the moment of birth.
- Geographic coordinates: Uses latitude and longitude to accurately determine house cusps and planetary placements relative to the birth location.
- Ayanamsha support: The
X-Ayanamsha header allows selection of the sidereal calculation system (e.g., Lahiri, Raman, KP), ensuring compatibility with different Vedic astrology traditions and schools of thought.
- Named dosha type identification: Goes beyond a simple yes/no result by identifying the specific Kalsarpa variant, each of which carries distinct astrological significance and effects.
- Partial vs. full dosha detection: Distinguishes between a complete Kalsarpa Dosha (all planets strictly between Rahu and Ketu) and a partial one (where one or more planets are outside the nodal axis), providing a nuanced analysis.
- Multilingual support: The
Accept-Language header enables localized descriptions and interpretations for a global user base.
