The Lal Kitab Debts API computes and returns a person's Lal Kitab karmic debts (Rin) based on their birth chart, along with a rendered chart image that visually represents the debt configuration. Lal Kitab debts — also known as Pitra Rin (ancestral debt), Matri Rin (maternal debt), Swayam Rin (self-debt), and others — are one of the most distinctive and practically significant concepts in Lal Kitab astrology. They identify specific karmic obligations carried from past lives, indicated by particular planetary placements in the natal chart, and form the basis for targeted remedy recommendations.
What This API Returns
Given a person's birth date, time, geographic coordinates, and visual configuration preferences, the API analyzes the birth chart through the lens of Lal Kitab debt theory and returns:
- Debt identification — a structured list of all active Lal Kitab debts present in the chart, classified by debt type (e.g., Pitra Rin, Matri Rin, Bhatri Rin, Swayam Rin, Stri Rin, Dhhan Rin) based on planetary house positions and combinations
- Causative planets and houses — the specific planets and house placements that trigger each identified debt, providing the astrological basis for the classification
- Debt descriptions — interpretive details for each debt, explaining the karmic implication and the life areas it is likely to affect
- Remedy indicators — guidance on which planetary influences need to be addressed, forming the foundation for Lal Kitab-specific remedy suggestions
- Rendered chart image — a server-side generated visual birth chart diagram styled according to the visual configuration supplied in the request body, with the debt-relevant planetary placements visible in context
- Ayanamsha-corrected calculations — all sidereal positions adjusted using the specified Ayanamsha for precise astronomical accuracy
Main Use Cases
- Debt analysis features — powering dedicated "Lal Kitab Debts" sections in astrology apps that explain a user's karmic obligations and their astrological basis
- Remedy recommendation engines — using the identified debts and their causative planets as inputs to generate targeted Lal Kitab remedies (e.g., specific donations, rituals, behavioral changes)
- Personalized horoscope reports — embedding debt analysis and the rendered chart image into automated PDF or web-based Lal Kitab reports
- Consultation tools — giving astrologers a structured, programmatic breakdown of a client's debt profile to support in-depth Lal Kitab consultations
- Educational platforms — illustrating the concept of Lal Kitab debts with real chart data and visual output to help students and enthusiasts understand this system
