API Reference / Reports & Utilities / Reports (JSON / PDF)
/v1/reports/kundli/brihad
Brihad Kundli — flagship 130-page horoscope (JSON, optional PDF).
Request
All requests require an Authorization header with your dv_live_* API key.
curl "https://api.lifeastroapi.com/v1/reports/kundli/brihad?date=1990-01-15&time=10%3A30&tz=Asia%2FKolkata&lat=19.076&lon=72.8777" \
-H "Authorization: Bearer YOUR_API_KEY"Query parameters
Checked against the API: a parameter is marked required when the request fails without it.
| Name | Required | Example | Description |
|---|---|---|---|
date | yes | 1990-01-15 | Birth date (YYYY-MM-DD). |
time | no | 10:30 | Birth time (HH:MM, 24-hour, local). Defaults to 12:00. |
tz | no | Asia/Kolkata | Birth place timezone: IANA name (Asia/Kolkata) or UTC offset (+05:30). |
lat | yes | 19.076 | Birth place latitude in decimal degrees. |
lon | yes | 72.8777 | Birth place longitude in decimal degrees. |
Response (200 OK)
The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.
{
"schema_version": 2,
"Locale": "",
"Branding": {
"CompanyName": "",
"LogoURL": "",
"PrimaryColor": "#1a1a1a",
"SecondaryColor": "#666666",
"FooterText": "Generated using LifeAstroAPI",
"WatermarkText": ""
},
"Subject": {
"Name": "Subject",
"BirthDate": "1990-01-15",
"BirthTime": "10:30 IST",
"BirthPlace": "19.0760, 72.8777",
"Lat": 19.076,
"Lon": 72.8777
},
"Ascendant": {
"sign": "Aquarius",
"dms_within": "26°23'30\"",
"nakshatra": "Purva Bhadrapada",
"pada": 2,
"nak_lord": "Jupiter"
},
"Planets": [
{
"name": "Sun",
"name_en": "Sun",
"placement": {
"sign": "Capricorn",
"dms_within": "01°03'47\"",
"nakshatra": "Uttara Ashadha",
"pada": 2,
"nak_lord": "Sun"
},
"house_num": 12,
"retro": false
},
{
"name": "Moon",
"name_en": "Moon",
"placement": {
"sign": "Leo",
"dms_within": "20°07'38\"",
"nakshatra": "Purva Phalguni",
"pada": 3,
"nak_lord": "Venus"
},
"house_num": 7,
"retro": false
}
],
"Houses": [
{
"HouseNum": 1,
"LordEN": "Saturn",
"LordHI": "शनि",
"LordSign": "Sagittarius",
"Body": "The ascendant governs the self, body, temperament, and overall vitality, the lens through which the whole chart expresses. Its lord currently occupies house 11, channelling these themes there."
},
{
"HouseNum": 2,
"LordEN": "Jupiter",
"LordHI": "गुरु",
"LordSign": "Gemini",
"Body": "Governs accumulated wealth, family, speech, food, and early upbringing, the resources and values one gathers. Its lord currently occupies house 5, channelling these themes there."
}
],
"Yogas": [
{
"NameEN": "Mercury-Saturn Conjunction",
"NameHI": "बुध-शनि युति",
"Effect": "A conjunction of two planets, their significations blend and jointly colour the affairs of the house they occupy.",
"Source": ""
},
{
"NameEN": "Sun-Venus Conjunction",
"NameHI": "सूर्य-शुक्र युति",
"Effect": "A conjunction of two planets, their significations blend and jointly colour the affairs of the house they occupy.",
"Source": ""
}
],
"CurrentDasha": {
"Lord": "Rahu",
"LordHI": "राहु",
"StartDate": "2022-11-06",
"EndDate": "2040-11-06",
"DurationY": 18,
"Body": "Rahu's mahadasha amplifies worldly desires, foreign connections, and unconventional paths."
},
"UpcomingDashas": [
{
"Lord": "Jupiter",
"LordHI": "गुरु",
"StartDate": "2040-11-06",
"EndDate": "2056-11-06",
"DurationY": 16,
"Body": "Jupiter's mahadasha brings wisdom, fortune, children, dharmic activities, and growth."
},
{
"Lord": "Saturn",
"LordHI": "शनि",
"StartDate": "2056-11-06",
"EndDate": "2075-11-06",
"DurationY": 19,
"Body": "Saturn's mahadasha emphasizes discipline, slow growth, hard work, and karmic lessons over its 19-year span."
}
],
"Remedies": [
{
"Title": "Hanuman Chalisa",
"Description": "Recite Hanuman Chalisa on Saturdays.",
"Category": "mantra"
},
{
"Title": "Donate black sesame",
"Description": "Donate black sesame, mustard oil, or iron on Saturdays.",
"Category": "donation"
}
],
"DivisionalCharts": [
{
"varga": "D2",
"name": "Hora",
"subtitle": "Hora (D2) governs wealth and prosperity.",
"lagna_sign": "Cancer",
"planets": [
{
"name": "Sun",
"sign": "Cancer",
"house": 1
},
{
"name": "Moon",
"sign": "Cancer",
"house": 1
}
]
},
{
"varga": "D3",
"name": "Drekkana",
"subtitle": "Drekkana (D3) governs siblings, courage and initiative.",
"lagna_sign": "Libra",
"planets": [
{
"name": "Sun",
"sign": "Capricorn",
"house": 4
},
{
"name": "Moon",
"sign": "Aries",
"house": 7
}
]
}
],
"Doshas": {
"Mangal": {
"NameEN": "Mangal Dosha",
"NameHI": "मंगल दोष",
"Severity": "cancelled",
"Body": "Mars sits in house 10 from the Lagna in a position that classically triggers Manglik, BUT the dosha is cancelled, own/exalted placement or benefic cancellation removes the affliction.",
"Source": "BPHS Ch.80 v.47 (cancellation clause)"
},
"KaalSarp": null,
"Pitra": null
},
"Predictions": [
{
"Area": "career",
"Body": "Career suits engineering, defence, surgery, real-estate, or any high-energy execution discipline. Push through opposition rather than going around it."
},
{
"Area": "marriage",
"Body": "Partnership benefits from a confident, public-facing spouse. Watch the tendency to dominate decisions; share the spotlight."
}
],
"Citations": [
{
"Topic": "Mangal Dosha",
"Source": "BPHS Ch.80 v.47 (cancellation clause)",
"Note": ""
}
],
"avakahada": {
"paya": "Silver",
"varna": "Kshatriya",
"vashya": "Vanchar",
"yoni": "Mushaka",
"gana": "Manushya",
"nadi": "Madhya",
"tatva": "Prithvi",
"nakshatra_lord": "Venus",
"rashi_lord": "Sun",
"lagna_lord": "Saturn"
},
"panchang": {
"tithi": "Panchami",
"vara": "Monday",
"nakshatra": "Purva Phalguni",
"yoga": "Saubhagya",
"karana": "Kaulava"
},
"gems": {
"stones": [
{
"kind": "Life Stone",
"planet": "Saturn",
"stone": "Blue Sapphire",
"reason": "Lagna (1st-house) lord"
},
{
"kind": "Fortune Stone",
"planet": "Venus",
"stone": "Diamond",
"reason": "9th-house (Bhagya) lord"
}
]
},
"ghata_chakra": {
"weekday": "Saturday",
"tithi_text": "3, 8, 13",
"month": "Jyeshtha",
"nakshatra": "Mula",
"yoga": "Dhriti",
"karana": "Bava",
"prahar": 1,
"ghata_rashi": "Virgo / Cancer"
},
"chalit": {
"houses": [
{
"house": 1,
"begin_sign": "Aquarius",
"begin_dms": "11°51'24\"",
"madhya_sign": "Aquarius",
"madhya_dms": "26°23'30\""
},
{
"house": 2,
"begin_sign": "Pisces",
"begin_dms": "11°51'24\"",
"madhya_sign": "Pisces",
"madhya_dms": "27°19'18\""
}
],
"planets": [
{
"name": "Sun",
"rashi_house": 12,
"chalit_house": 11,
"shifted": true
},
{
"name": "Moon",
"rashi_house": 7,
"chalit_house": 7,
"shifted": false
}
]
},
"kp": {
"cusps": [
{
"house": 1,
"sign": "Aquarius",
"dms": "26°23'30\"",
"star_lord": "Jupiter",
"sub_lord": "Ketu",
"sub_sub_lord": "Saturn"
},
{
"house": 2,
"sign": "Aries",
"dms": "02°51'57\"",
"star_lord": "Ketu",
"sub_lord": "Venus",
"sub_sub_lord": "Mercury"
}
],
"planet_significators": [
{
"key": "Sun",
"values": [
11,
7
]
},
{
"key": "Moon",
"values": [
11,
6
]
}
],
"house_significators": [
{
"house": 1,
"planets": [
"Saturn"
]
},
{
"house": 2,
"planets": [
"Rahu",
"Mars"
]
}
],
"ruling_planets": {
"day_lord": "Moon",
"lagna_nakshatra_lord": "Jupiter",
"lagna_rashi_lord": "Saturn",
"lagna_sub_lord": "Ketu",
"moon_nakshatra_lord": "Venus",
"moon_rashi_lord": "Sun",
"moon_sub_lord": "Jupiter"
}
},
"jaimini": {
"charakarakas": [
{
"karaka": "Atmakaraka",
"planet": "Mars"
},
{
"karaka": "Amatyakaraka",
"planet": "Saturn"
}
],
"karakamsa_sign": "Aquarius",
"swamsa_sign": "Aquarius",
"arudha_padas": [
{
"label": "A1",
"name": "Arudha Lagna",
"sign": "Libra",
"house": 9
},
{
"label": "A2",
"name": "Dhana Pada",
"sign": "Gemini",
"house": 5
}
]
},
"ishta_devata": {
"deity": "Shiva",
"twelfth_sign": "Capricorn",
"determining_graha": "Sun",
"body": ""
},
"maitri": {
"order": [
"Sun",
"Moon"
],
"naisargik": [
{
"planet": "Sun",
"relations": {
"Jupiter": "Mitra",
"Mars": "Mitra",
"Mercury": "Sama",
"Moon": "Mitra",
"Saturn": "Shatru",
"Sun": "•",
"Venus": "Shatru"
}
},
{
"planet": "Moon",
"relations": {
"Jupiter": "Sama",
"Mars": "Sama",
"Mercury": "Mitra",
"Moon": "•",
"Saturn": "Sama",
"Sun": "Mitra",
"Venus": "Sama"
}
}
],
"tatkalik": [
{
"planet": "Sun",
"relations": {
"Jupiter": "TempEnemy",
"Mars": "TempFriend",
"Mercury": "TempFriend",
"Moon": "TempEnemy",
"Saturn": "TempFriend",
"Sun": "•",
"Venus": "TempEnemy"
}
},
{
"planet": "Moon",
"relations": {
"Jupiter": "TempFriend",
"Mars": "TempFriend",
"Mercury": "TempEnemy",
"Moon": "•",
"Saturn": "TempEnemy",
"Sun": "TempEnemy",
"Venus": "TempEnemy"
}
}
],
"panchadha": [
{
"planet": "Sun",
"relations": {
"Jupiter": "Sama",
"Mars": "Adhimitra",
"Mercury": "Mitra",
"Moon": "Sama",
"Saturn": "Sama",
"Sun": "•",
"Venus": "Adhishatru"
}
},
{
"planet": "Moon",
"relations": {
"Jupiter": "Mitra",
"Mars": "Mitra",
"Mercury": "Sama",
"Moon": "•",
"Saturn": "Shatru",
"Sun": "Sama",
"Venus": "Shatru"
}
}
]
},
"avasthas": [
{
"planet": "Sun",
"baladi": "Mrita",
"jagradadi": "Sushupta",
"deeptadi": "Vikala"
},
{
"planet": "Moon",
"baladi": "Vriddha",
"jagradadi": "Swapna",
"deeptadi": "Pramudita"
}
],
"lal_kitab": {
"planets": [
{
"name": "Sun",
"house": 12,
"sign": "Pisces"
},
{
"name": "Moon",
"house": 7,
"sign": "Libra"
}
],
"rins": [
{
"name": "Pitru Rin",
"present": true,
"body": ""
},
{
"name": "Swayam Rin",
"present": false,
"body": ""
}
],
"teva": [
{
"name": "Dharmi Kundli",
"present": false
},
{
"name": "Ratandh Kundli",
"present": false
}
]
},
"shadbala": [
{
"planet": "Sun",
"total_rupas": 6.04,
"rank": 6
},
{
"planet": "Moon",
"total_rupas": 7.92,
"rank": 1
}
],
"bhava_bala": [
{
"house": 1,
"bhavadhipati": 270.85,
"bhava_dig_bala": 60,
"bhava_drsti": 35.21,
"total": 366.06
},
{
"house": 2,
"bhavadhipati": 472.24,
"bhava_dig_bala": 40,
"bhava_drsti": 35.66,
"total": 547.9
}
],
"ashtakavarga": {
"sav": [
33,
31
],
"sav_total": 337,
"prastar": [
{
"planet": "Sun",
"contributors": [
"Sun",
"Moon"
],
"grid": [
[
1,
0
],
[
0,
1
]
],
"per_sign": [
4,
4
],
"total": 48
},
{
"planet": "Moon",
"contributors": [
"Sun",
"Moon"
],
"grid": [
[
0,
0
],
[
0,
1
]
],
"per_sign": [
6,
4
],
"total": 49
}
]
},
"varshaphal": [
{
"year": 2026,
"muntha_sign": "Aquarius",
"muntha_house": 1,
"varsha_lord": "Sun",
"sahams": [
{
"name": "Punya",
"sign": "Aries",
"dms": "24°03'08\"",
"lord": "Mars",
"verified": true
},
{
"name": "Vidya",
"sign": "Leo",
"dms": "09°50'43\"",
"lord": "Sun",
"verified": true
}
],
"panchavargeeya": [
{
"planet": "Sun",
"vishwa": 8.19
},
{
"planet": "Moon",
"vishwa": 8.06
}
],
"summary": ""
},
{
"year": 2027,
"muntha_sign": "Pisces",
"muntha_house": 2,
"varsha_lord": "Mercury",
"sahams": [
{
"name": "Punya",
"sign": "Taurus",
"dms": "26°01'52\"",
"lord": "Venus",
"verified": true
},
{
"name": "Vidya",
"sign": "Sagittarius",
"dms": "22°02'12\"",
"lord": "Jupiter",
"verified": true
}
],
"panchavargeeya": [
{
"planet": "Sun",
"vishwa": 8.19
},
{
"planet": "Moon",
"vishwa": 11.56
}
],
"summary": ""
}
],
"GeneratedAt": "2026-10-17T20:44:06.53516Z"
}Errors
Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.
401 Unauthorized
{
"error": {
"code": "unauthorized",
"message": "missing or invalid API key",
"request_id": "req_01hqy7k8c3e7m1n"
}
}402 Payment Required
{
"error": {
"code": "trial_exhausted",
"message": "your free trial credits are exhausted — pick a plan to continue",
"top_up_url": "https://lifeastroapi.com/pricing",
"request_id": "req_01hqy7k8c3e7m1n"
}
}429 Too Many Requests
{
"error": {
"code": "rate_limited",
"message": "rate limit exceeded; retry after 12 seconds",
"request_id": "req_01hqy7k8c3e7m1n"
}
}Try it
Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 1,500 free credits. Sign up.