Bhava Bala and Graha Avastha API
The classical layer: house cusps, bhava bala, prastara ashtakavarga, graha avasthas, sthira karakas, lucky points
POST/v1/kundli/classical
2 credits · Secret key (test or live) · getClassicalChart
What astrologics.in's full report calls its classical layer. cusps: Placidus (what KP uses; null at latitudes where it is undefined) beside the Sripati bhava arambh and madhya, sidereal degrees. Needs a birth time.
Request body
birthBirth requireddatestring (date) requirede.g.
"1990-08-13"timestringpattern
^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$· e.g."06:30"time_accuracystringWith "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
one of
exact,approximate,unknown· default"exact"placeCoordinates or object or object requiredCoordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
One of:
- Coordinates
Fields
latitudenumber required≥ -90 · ≤ 90
longitudenumber required≥ -180 · ≤ 180
No other fields are accepted.
- object
Fields
place_idstring required
No other fields are accepted.
- object
Fields
querystring requiredat least 2 characters · at most 120 characters
No other fields are accepted.
- Coordinates
timezonestring"auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
default
"auto"
No other fields are accepted.
optionsOptionsayanamsastringEach system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
one of
lahiri,raman,krishnamurti,yukteshwar,fagan_bradley· default"lahiri"house_systemstringone of
whole_sign· default"whole_sign"nodestringThe Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
one of
true,mean· default"true"langstringone of
en,hi· default"en"viewstringcompact drops labels and prose — for LLM callers.
one of
full,compact· default"full"tonestringdescriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
one of
default,descriptive· default"default"dasha_yearnumberDays in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
one of
365.25,365.2422,360· default365.25
No other fields are accepted.
No other fields are accepted.
Response
JSON { data, meta, warnings }, where data is:
cuspsobject requiredsystemstring requiredplacidusarray of number or null requiredOne of:
- array of number
- null
bhava_arambharray of number requiredbhava_madhyaarray of number required
bhava_balaarray of object requiredhouseinteger required≥ 1 · ≤ 12
signstring requiredlordstring requiredadhipati_balanumber requireddig_balanumber requireddrishti_balanumber requiredtotalnumber requiredrupasnumber requiredrankinteger required≥ 1 · ≤ 12
prastaraobject requiredcontributorsarray of string requiredsignsarray of string requiredplanetsmap of object requiredFields
gridmap of array of integer requiredtotalsarray of integer requiredsuminteger required
avasthamap of object requiredjagratstring requiredbaladistring requireddeeptadistring requireddignitystring required
sthira_karakasarray of object requiredkarakastring requiredplanetstring required
luckyobject requirednumbersarray of integer requiredunlucky_numbersarray of integer requiredyearsarray of array of integer requireddaysarray of string requiredplanetsarray of string requiredfriendly_signsarray of string requiredlagnasarray of string requiredmetalstring requiredgemstring requiredlagna_lordstring requiredrashi_lordstring required
Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.
Example request
curl -X POST 'https://api.astrologics.in/v1/kundli/classical' \
-H 'Authorization: Bearer al_test_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}'Node.js
const res = await fetch("https://api.astrologics.in/v1/kundli/classical", {
method: "POST",
headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
"birth": {
"date": "1990-08-13",
"time": "06:30",
"place": {
"latitude": 28.6139,
"longitude": 77.209
}
}
}),
});
console.log(JSON.stringify(await res.json(), null, 2));Python
import json
import urllib.error
import urllib.request
body = {
"birth": {
"date": "1990-08-13",
"time": "06:30",
"place": {
"latitude": 28.6139,
"longitude": 77.209,
},
},
}
req = urllib.request.Request(
"https://api.astrologics.in/v1/kundli/classical",
method="POST",
headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
data=json.dumps(body).encode(),
)
try:
with urllib.request.urlopen(req) as res:
print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
print(err.code, err.read().decode())PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/kundli/classical');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}',
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;Example response
200 OK · 22,722 characters
{
"data": {
"cusps": {
"system": "Placidus (KP) + Sripati (chalit)",
"placidus": [
124.27,
150.0796,
179.7678,
212.022,
244.4165,
275.3319,
304.27,
330.0796,
359.7678,
32.022,
64.4165,
95.3319
],
"bhava_arambh": [
108.8953,
138.8953,
168.146,
197.3967,
227.3967,
258.146,
288.8953,
318.8953,
348.146,
17.3967,
47.3967,
78.146
],
"bhava_madhya": [
124.27,
153.5207,
182.7713,
212.022,
242.7713,
273.5207,
304.27,
333.5207,
2.7713,
32.022,
62.7713,
93.5207
]
},
"bhava_bala": [
{
"house": 1,
"sign": "leo",
"lord": "sun",
"adhipati_bala": 81,
"dig_bala": 30,
"drishti_bala": 0,
"total": 111,
"rupas": 1.85,
"rank": 5
},
{
"house": 2,
"sign": "virgo",
"lord": "mercury",
"adhipati_bala": 65,
"dig_bala": 15,
"drishti_bala": -11.3,
"total": 68.8,
"rupas": 1.15,
"rank": 10
},
{
"house": 3,
"sign": "libra",
"lord": "venus",
"adhipati_bala": 57,
"dig_bala": 15,
"drishti_bala": -11.3,
"total": 60.8,
"rupas": 1.01,
"rank": 12
},
{
"house": 4,
"sign": "scorpio",
"lord": "mars",
"adhipati_bala": 82,
"dig_bala": 30,
"drishti_bala": 0,
"total": 112,
"rupas": 1.87,
"rank": 4
},
{
"house": 5,
"sign": "sagittarius",
"lord": "jupiter",
"adhipati_bala": 91,
"dig_bala": 15,
"drishti_bala": 0,
"total": 106,
"rupas": 1.77,
"rank": 6
},
{
"house": 6,
"sign": "capricorn",
"lord": "saturn",
"adhipati_bala": 71,
"dig_bala": 15,
"drishti_bala": 30,
"total": 116,
"rupas": 1.93,
"rank": 3
},
{
"house": 7,
"sign": "aquarius",
"lord": "saturn",
"adhipati_bala": 71,
"dig_bala": 30,
"drishti_bala": -15,
"total": 86,
"rupas": 1.43,
"rank": 8
},
{
"house": 8,
"sign": "pisces",
"lord": "jupiter",
"adhipati_bala": 91,
"dig_bala": 15,
"drishti_bala": 15,
"total": 121,
"rupas": 2.02,
"rank": 1
},
{
"house": 9,
"sign": "aries",
"lord": "mars",
"adhipati_bala": 82,
"dig_bala": 15,
"drishti_bala": 0,
"total": 97,
"rupas": 1.62,
"rank": 7
},
{
"house": 10,
"sign": "taurus",
"lord": "venus",
"adhipati_bala": 57,
"dig_bala": 60,
"drishti_bala": 0,
"total": 117,
"rupas": 1.95,
"rank": 2
},
{
"house": 11,
"sign": "gemini",
"lord": "mercury",
"adhipati_bala": 65,
"dig_bala": 15,
"drishti_bala": 0,
"total": 80,
"rupas": 1.33,
"rank": 9
},
{
"house": 12,
"sign": "cancer",
"lord": "moon",
"adhipati_bala": 65,
"dig_bala": 15,
"drishti_bala": -15,
"total": 65,
"rupas": 1.08,
"rank": 11
}
],
"prastara": {
"contributors": [
"sun",
"moon",
"mars",
"mercury",
"jupiter",
"venus",
"saturn",
"lagna"
],
"signs": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"planets": {
"sun": {
"grid": {
"sun": [
1,
1,
0,
1,
1,
0,
1,
0,
0,
1,
1,
1
],
"moon": [
0,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1,
0
],
"mars": [
1,
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0
],
"mercury": [
1,
1,
1,
1,
0,
0,
1,
0,
1,
1,
0,
0
],
"jupiter": [
0,
1,
0,
0,
0,
0,
0,
1,
1,
0,
0,
1
],
"venus": [
0,
0,
1,
0,
0,
0,
0,
0,
1,
1,
0,
0
],
"saturn": [
0,
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1
],
"lagna": [
0,
1,
1,
1,
0,
0,
1,
1,
0,
1,
0,
0
]
},
"totals": [
3,
5,
5,
5,
2,
2,
5,
3,
5,
7,
3,
3
],
"sum": 48
},
"moon": {
"grid": {
"sun": [
1,
1,
0,
0,
0,
1,
0,
0,
1,
1,
1,
0
],
"moon": [
1,
0,
1,
0,
0,
1,
1,
0,
0,
1,
1,
0
],
"mars": [
0,
1,
1,
0,
1,
1,
0,
0,
1,
1,
1,
0
],
"mercury": [
0,
1,
1,
0,
1,
0,
1,
1,
1,
0,
1,
1
],
"jupiter": [
1,
1,
1,
1,
0,
0,
1,
0,
0,
1,
1,
0
],
"venus": [
1,
1,
0,
0,
0,
1,
1,
1,
0,
1,
0,
1
],
"saturn": [
1,
1,
0,
0,
0,
0,
1,
0,
0,
0,
1,
0
],
"lagna": [
0,
1,
1,
0,
0,
0,
1,
0,
0,
1,
0,
0
]
},
"totals": [
5,
7,
5,
1,
2,
4,
6,
2,
3,
6,
6,
2
],
"sum": 49
},
"mars": {
"grid": {
"sun": [
1,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0,
0
],
"moon": [
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1,
0
],
"mars": [
1,
1,
0,
1,
0,
0,
1,
1,
0,
1,
1,
0
],
"mercury": [
0,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"jupiter": [
1,
1,
1,
0,
0,
0,
0,
0,
1,
0,
0,
0
],
"venus": [
0,
1,
1,
0,
0,
0,
0,
0,
1,
0,
1,
0
],
"saturn": [
0,
0,
1,
1,
1,
1,
1,
0,
1,
0,
0,
1
],
"lagna": [
0,
1,
1,
0,
1,
0,
1,
0,
0,
1,
0,
0
]
},
"totals": [
3,
5,
6,
2,
2,
3,
4,
2,
5,
3,
3,
1
],
"sum": 39
},
"mercury": {
"grid": {
"sun": [
0,
1,
1,
0,
0,
0,
0,
1,
1,
0,
0,
1
],
"moon": [
0,
1,
0,
1,
0,
1,
0,
1,
0,
1,
1,
0
],
"mars": [
1,
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0
],
"mercury": [
1,
1,
1,
1,
1,
0,
1,
0,
1,
1,
0,
0
],
"jupiter": [
0,
1,
1,
0,
0,
0,
0,
0,
1,
0,
1,
0
],
"venus": [
0,
1,
0,
1,
1,
1,
1,
1,
0,
0,
1,
1
],
"saturn": [
0,
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1
],
"lagna": [
0,
1,
1,
0,
1,
1,
0,
1,
0,
1,
0,
1
]
},
"totals": [
2,
7,
5,
5,
4,
4,
4,
5,
5,
5,
4,
4
],
"sum": 54
},
"jupiter": {
"grid": {
"sun": [
1,
1,
0,
1,
1,
1,
1,
0,
0,
1,
1,
1
],
"moon": [
0,
1,
0,
0,
1,
0,
1,
0,
1,
0,
1,
0
],
"mars": [
1,
1,
0,
1,
0,
0,
1,
1,
0,
1,
1,
0
],
"mercury": [
1,
1,
1,
0,
1,
1,
0,
1,
1,
1,
0,
0
],
"jupiter": [
1,
1,
0,
1,
1,
1,
1,
0,
0,
1,
1,
0
],
"venus": [
1,
1,
0,
0,
1,
0,
0,
1,
1,
0,
0,
1
],
"saturn": [
1,
1,
0,
0,
0,
0,
0,
1,
0,
0,
1,
0
],
"lagna": [
1,
1,
1,
0,
1,
1,
0,
1,
1,
1,
1,
0
]
},
"totals": [
7,
8,
2,
3,
6,
4,
4,
5,
4,
5,
6,
2
],
"sum": 56
},
"venus": {
"grid": {
"sun": [
0,
1,
1,
0,
0,
0,
0,
0,
0,
0,
1,
0
],
"moon": [
1,
1,
1,
1,
1,
0,
0,
1,
1,
0,
1,
1
],
"mars": [
0,
0,
1,
1,
0,
1,
0,
0,
1,
0,
1,
1
],
"mercury": [
1,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"jupiter": [
1,
1,
0,
0,
0,
0,
0,
1,
0,
0,
1,
1
],
"venus": [
1,
1,
0,
1,
1,
1,
1,
1,
0,
0,
1,
1
],
"saturn": [
1,
0,
0,
1,
1,
1,
1,
0,
0,
0,
1,
1
],
"lagna": [
1,
0,
1,
0,
1,
1,
1,
1,
1,
0,
0,
1
]
},
"totals": [
6,
4,
5,
4,
4,
4,
4,
4,
4,
1,
6,
6
],
"sum": 52
},
"saturn": {
"grid": {
"sun": [
1,
1,
0,
1,
1,
0,
1,
0,
0,
1,
1,
0
],
"moon": [
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1,
0
],
"mars": [
0,
0,
1,
0,
1,
1,
0,
0,
0,
1,
1,
1
],
"mercury": [
1,
1,
1,
1,
0,
0,
0,
0,
0,
1,
0,
1
],
"jupiter": [
0,
1,
1,
0,
0,
0,
0,
1,
1,
0,
0,
0
],
"venus": [
0,
1,
1,
0,
0,
0,
0,
0,
1,
0,
0,
0
],
"saturn": [
1,
1,
0,
0,
0,
0,
1,
0,
0,
0,
1,
0
],
"lagna": [
0,
1,
1,
0,
1,
0,
1,
1,
0,
1,
0,
0
]
},
"totals": [
3,
6,
6,
2,
3,
2,
3,
2,
2,
4,
4,
2
],
"sum": 39
}
}
},
"avastha": {
"sun": {
"jagrat": "Swapna (dreaming)",
"baladi": "Bala (infant)",
"deeptadi": "Mudita (delighted)",
"dignity": "Friend's sign"
},
"moon": {
"jagrat": "Swapna (dreaming)",
"baladi": "Vriddha (old)",
"deeptadi": "Shanta (quiet)",
"dignity": "Neutral sign"
},
"mars": {
"jagrat": "Jagrat (awake)",
"baladi": "Mrita (dead)",
"deeptadi": "Swastha (at home)",
"dignity": "Own sign"
},
"mercury": {
"jagrat": "Swapna (dreaming)",
"baladi": "Vriddha (old)",
"deeptadi": "Mudita (delighted)",
"dignity": "Friend's sign"
},
"jupiter": {
"jagrat": "Jagrat (awake)",
"baladi": "Mrita (dead)",
"deeptadi": "Deepta (blazing)",
"dignity": "Exalted"
},
"venus": {
"jagrat": "Sushupta (asleep)",
"baladi": "Mrita (dead)",
"deeptadi": "Dina (distressed)",
"dignity": "Enemy's sign"
},
"saturn": {
"jagrat": "Swapna (dreaming)",
"baladi": "Mrita (dead)",
"deeptadi": "Shanta (quiet)",
"dignity": "Neutral sign"
}
},
"sthira_karakas": [
{
"karaka": "Atma (soul)",
"planet": "sun"
},
{
"karaka": "Amatya (career)",
"planet": "mercury"
},
{
"karaka": "Bhratri (siblings)",
"planet": "mars"
},
{
"karaka": "Matri (mother)",
"planet": "moon"
},
{
"karaka": "Pitri (father)",
"planet": "jupiter"
},
{
"karaka": "Gnati (kin, rivals)",
"planet": "saturn"
},
{
"karaka": "Dara (spouse)",
"planet": "venus"
}
],
"lucky": {
"numbers": [
1,
3,
9
],
"unlucky_numbers": [
2,
4,
6,
8
],
"years": [
[
1,
10,
19,
28
],
[
3,
12,
21,
30
]
],
"days": [
"sunday",
"thursday",
"tuesday"
],
"planets": [
"sun",
"jupiter",
"mars"
],
"friendly_signs": [
"cancer",
"aries",
"scorpio",
"sagittarius",
"pisces"
],
"lagnas": [
"leo",
"scorpio",
"sagittarius",
"aquarius",
"aries",
"taurus"
],
"metal": "Copper",
"gem": "Red coral",
"lagna_lord": "sun",
"rashi_lord": "mars"
}
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 2,
"ayanamsa": "lahiri",
"house_system": "whole_sign",
"node": "true",
"timezone_used": {
"name": "Asia/Kolkata",
"utc_offset": "+05:30",
"source": "auto"
}
},
"warnings": []
}Try it
More in Kundli
- Kundli Chart API: Lagna and Nine Grahas: Birth chart: lagna and the nine grahas
- Avakhada Birth Details API: Avakhada birth details
- Divisional Charts API (D1–D60, Navamsa): Divisional charts D1–D60
- Graha Drishti (Aspects) API: Graha drishti: houses and planets aspected
- Kundli Yogas API: Yogas present, with strength and rule
- Ashtakavarga API: Bhinna and Sarva Ashtakavarga, the bindus of the signs being transited, each planet's best and worst signs
- Wealth Astrology API (D2, D9, D10): Wealth reading from D1, D2, D9 and D10: hora placements, the D10 lagna and 10th lord, vargottama, scores 0–10
- Gemstone Recommendation API: Gemstones by functional lordship: the lagna lord's, the 9th (or 5th) lord's, the mahadasha lord's, and those to avoid
- Shadbala API: Shadbala: the six-fold strength of the seven grahas
- Outer Planets in the Kundli API: Uranus, Neptune and Pluto: sidereal position, house from the lagna, and the house reading in English and Hindi
- Dwadasamsa (D12) API: Dwadasamsa (D12) read for the lineage: father, mother, the 4th and 9th, strength 0–10
- Upagrahas API (Gulika and More): Upagrahas: the five from the Sun, and Kala, Mrityu, Ardhaprahara, Yamaghantaka and Gulika from the day's eight parts
- Arudha Lagna and Upapada API: Arudha padas of the twelve houses, with Arudha Lagna and Upapada
- Jaimini Chara Karaka API: Jaimini chara karakas on the seven-planet scheme, with the karakamsha
- Bhav Chalit Chart API: Bhav chalit: the Sripati bhavas, and which planets shift from their rashi house
- Planet Combustion (Asta and Uday) API: Asta and Uday: when each planet sets and rises near the Sun, for a place
- Sidereal Ephemeris Series API: A series of sidereal positions over a range, at up to 400 steps
- Rashi Reference API: The 12 rashis: span, lord, element, modality, varna, vashya and nakshatras
- Nakshatra Reference API: The 27 nakshatras: span, lord, gana, yoni, nadi, deity and symbol
- Sidereal Planet Positions API: Sidereal positions at any moment and place
- Planets Now API: The sky now: sidereal positions at the top of the current hour
- Retrograde Cycle API (Saturn to Pluto): The retrograde cycle of Saturn, Uranus, Neptune or Pluto: its stations and whether it is retrograde now
- Kundli Bundle API: Several Charts in One Call: Several chart operations in one call: one rate-limit slot, charged their sum less one credit