Lal Kitab Debts API

Access Lal Kitab Debts from the DivineAPI Lal Kitab suite. Based on the principles of Lal Kitab (the Red Book of Vedic astrology), this endpoint returns the Lal Kitab planetary debts (Rin) present in the chart for the provided birth details.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/debts

Returns the requested Lal Kitab data in the response.

Supported Language Codes

You can localize the API response by passing the lan parameter in the request body.

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Support Article: Translating Vedic APIs into Different Languages

Headers

Name	Type	Description
Authorization *	String	Your API Access Token, e.g. `Bearer {token}`

Request Body

Name	Type	Description
api_key *	String	Your API key
full_name *	String	Full name, e.g. `Rahul Kumar`
day *	Integer	Date of birth, e.g. `24`
month *	Integer	Month of birth, e.g. `05`
year *	Integer	Year of birth, e.g. `2023`
hour *	Integer	Hour (24-hour format), e.g. `14`
min *	Integer	Minute, e.g. `40`
sec *	Integer	Second, e.g. `43`
gender *	String	Gender, e.g. `male`
place *	String	Place of birth, e.g. `New Delhi`
lat *	Float	Latitude, e.g. `28.7041`
lon *	Float	Longitude, e.g. `77.1025`
tzone *	Float	Timezone, e.g. `5.5` — See Timezone List
lan	String	Language code as per the table above; default is `en`

200: OK Lal Kitab Debts Fetched Successfully

{
    "success": 1,
    "data": {
        "debts": {
            "pitru_rin": {
                "name": "Pitru Rin",
                "english_name": "Ancestral / Father's Debt",
                "afflicted_planet": "Jupiter",
                "is_valid": true,
                "conclusion": "Your horoscope is afflicted with Pitru Rin (Debt of Ancestors).",
                "matched_conditions": [
                    "Rahu/Ketu in H5 and Sun not in H1/H11",
                    "Sun/Moon/Mars in H7/H10 and Saturn not in H3/H4"
                ],
                "cause": "Venus, Mercury, or Rahu in 2nd/5th/9th/12th house, or specific Mercury+H9 and Jupiter Kendra combinations.",
                "karmic_meaning": "Unresolved karma or unfulfilled duties of ancestors (especially paternal), such as not performing Shraddha and other death rituals.",
                "manifestation": [
                    "Loss or theft of wealth, difficulties especially in later life, or repeated financial problems.",
                    "False allegations could be made against the native or even imprisonment."
                ],
                "indications": [
                    "Hairs turn grey at an early age or vanish.",
                    "A neighboring temple or peepal tree is destroyed."
                ],
                "remedies": [
                    "Collect money from each family member and donate in a temple or serve in the temple.",
                    "Plant a Peepal tree or take care of one.",
                    "Wear a Turban.",
                    "Put a tilak of turmeric or saffron on forehead.",
                    "Clean your nose daily in the morning."
                ]
            },
            "matru_rin": {
                "name": "Matru Rin",
                "english_name": "Mother's Debt",
                "afflicted_planet": "Moon",
                "is_valid": false,
                "conclusion": "Your horoscope is free of Matru Rin (Debt of Mother).",
                "matched_conditions": [],
                "cause": "Ketu placed in the 4th house.",
                "karmic_meaning": "Neglect or suffering caused to mother or maternal figures in past lives.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "stree_rin": {
                "name": "Stree Rin",
                "english_name": "Debt to Women",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Stree Rin (Debt to Women).",
                "matched_conditions": [],
                "cause": "Sun, Moon, or Rahu placed in the 2nd or 7th house.",
                "karmic_meaning": "Mistreatment, injustice, or unfulfilled responsibilities toward women (wife, sisters). Dowry-related troubles to women in the family.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "bhratru_rin": {
                "name": "Bhratru Rin",
                "english_name": "Debt to Brother / Relatives",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Bhratru Rin (Debt to Brother/Relatives).",
                "matched_conditions": [],
                "cause": "Ketu and Mercury both placed in the 1st or 8th house.",
                "karmic_meaning": "Betrayal, injustice, or lack of support in sibling relationships in past lives. Burning of crops or someone's house, or killing a pregnant animal.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "putri_bahen_rin": {
                "name": "Putri / Behen Rin",
                "english_name": "Debt to Daughter or Sister",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Putri/Behen Rin (Debt to Daughter or Sister).",
                "matched_conditions": [],
                "cause": "Moon placed in the 3rd or 6th house.",
                "karmic_meaning": "Cruelty towards female offspring or sisters in past lives.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "nirdayi_rin": {
                "name": "Nirdayi Rin",
                "english_name": "Debt of Merciless Karma",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Nirdayi Rin (Debt of Merciless Karma).",
                "matched_conditions": [],
                "cause": "Sun, Moon, or Mars placed in the 10th or 11th house.",
                "karmic_meaning": "Cruelty, exploitation, harm or murder done knowingly or out of power in previous lives. Exploiting or looting someone for money.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "ajanma_rin": {
                "name": "Ajanma Rin",
                "english_name": "Debt of the Unborn",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Ajanma Rin (Debt of the Unborn).",
                "matched_conditions": [],
                "cause": "Sun, Moon, or Mars placed in the 12th house.",
                "karmic_meaning": "Debt arising due to fraud committed against any known person or their family in past lives.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "atma_rin": {
                "name": "Atma Rin",
                "english_name": "Self-inflicted Debt",
                "afflicted_planet": null,
                "is_valid": true,
                "conclusion": "Your horoscope is afflicted with Atma Rin (Self-inflicted Debt).",
                "matched_conditions": [
                    "Saturn in H5",
                    "Rahu in H5"
                ],
                "cause": "Saturn, Venus, Rahu, or Ketu placed in the 5th house.",
                "karmic_meaning": "Native turned atheist or discarded old beliefs and traditions, or indulged in blasphemy in past lives.",
                "manifestation": [
                    "Setbacks in career or reputation.",
                    "All wealth and reputation is lost abruptly.",
                    "Health suffers badly.",
                    "Cattles are lost.",
                    "These mishappenings often occur when the son of the native is 11 months or 11 years of age."
                ],
                "indications": [
                    "Fire-place beneath the house.",
                    "Roof will have multiple holes for direct entrance of sunlight."
                ],
                "remedies": [
                    "Worship Surya Dev and perform his rituals.",
                    "Collect money from all family members for household expenses.",
                    "Eat sweets and drink water before starting a fresh task."
                ]
            },
            "deva_rin": {
                "name": "Deva Rin",
                "english_name": "Debt to the Divine / Higher Powers",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Deva Rin (Debt to the Divine).",
                "matched_conditions": [],
                "cause": "Moon and Mars both placed in the 6th house.",
                "karmic_meaning": "Abandoning spiritual responsibilities or misusing divine blessings in past lives.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            },
            "sarva_jeevan_rin": {
                "name": "Sarva Jeevan Rin",
                "english_name": "Lifetime Debt",
                "afflicted_planet": null,
                "is_valid": false,
                "conclusion": "Your horoscope is free of Sarva Jeevan Rin (Lifetime Debt).",
                "matched_conditions": [],
                "cause": "Afflicted 12th house, especially by Rahu, or highly malefic planetary combinations in H12.",
                "karmic_meaning": "Deep-rooted karmic burdens carried over several lifetimes.",
                "manifestation": [],
                "indications": [],
                "remedies": []
            }
        }
    }
}

Code Integration Examples

Below are examples for using this API in different programming environments.

cURL Example

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/debts' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \

NodeJS Example

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/debts',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript (jQuery AJAX) Example

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/debts",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python Example

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/debts"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

This API serves as a foundation for further astrological computations, including Kundli generation, planetary charts, yogas, and personalized reports. It provides all key birth-time astrological parameters such as tithi, nakshatra, rashi, yoga, karana, varna, gana, and planetary influences, essential for deeper Vedic analysis.