/v1/chart/kundli-facts

Whole birth chart as data in one call: lagna, planets (sign, degree, house, nakshatra, pada, retrograde, combust, dignity, neecha bhanga, vargottama, houses ruled, shadbala, avastha, varga placements), houses (sign, lord, SAV, bhava bala, occupants, aspects), chara karakas, avakhada, and optionally yogas and doshas.

What this tells you

One call for the chart facts that otherwise take a dozen /v1/chart/* calls: lagna, every graha with its sign, degree, house, nakshatra, dignity, combustion, retrogression, neecha bhanga, vargottama, houses ruled, shadbala, avastha and varga placements; every house with its lord, SAV bindus, bhava bala, occupants and aspects; Jaimini chara karakas and the avakhada chakra. Add include=yogas (or all) to get the /v1/chart/yogas and /v1/chart/doshas items in the same response. Every number comes from the same functions as the individual routes, so it matches them exactly. Ids only, no localized text: planet ids sun, moon, mars, mercury, jupiter, venus, saturn, rahu, ketu; sign_index is 0-based (0 = Aries … 11 = Pisces); house is the 1-based whole-sign house from the lagna; nakshatra index is 0-based (0 = Ashwini … 26 = Revati).

Birth details are unprefixed: `date`, `time`, `tz`, `lat`, `lon` (time defaults to 12:00). `gender` (male/female) only narrows Mahabhagya when yogas are included.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.lifeastroapi.com/v1/chart/kundli-facts?date=1990-01-15&tz=Asia%2FKolkata&lat=19.076&lon=72.8777&time=10%3A30" \
  -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).
`tz`	yes	`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.
`time`	no	`10:30`	Birth time (HH:MM, 24-hour, local). Defaults to 12:00.
`ayanamsa`	no	—	Ayanamsa (sidereal offset) to use. Defaults to lahiri.
`vargas`	no	—	Comma list of divisional charts (D2..D60, or names such as navamsa). Default D9. D1 is rejected (planets already carry it); at most 16.
`include`	no	—	Comma list of optional sections: shadbala, bhavabala, ashtakvarga, aspects, avastha, karakas, avakhada, yogas, or all. Default: every section except yogas.
`gender`	no	—	Optional. Narrows Mahabhagya (male day birth / female night birth) exactly like /v1/vedic/narrative/yogas.

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.

200 response

{
  "date": "1990-01-15",
  "time": "10:30",
  "location": {
    "lat": 19.076,
    "lon": 72.8777,
    "alt": 0
  },
  "tz": "Asia/Kolkata",
  "ayanamsa": "lahiri",
  "ayanamsa_value": 23.71795,
  "house_system": "whole_sign",
  "conventions": {
    "bhava_bala": "bhava bala total in shashtiamshas, as /v1/chart/bhavabala",
    "house": "1-based whole-sign house from the lagna sign (varga house from the varga lagna)",
    "nakshatra_idx": "0-based, Ashwini=0 ... Revati=26; pada 1..4",
    "planet_ids": "sun, moon, mars, mercury, jupiter, venus, saturn, rahu, ketu",
    "shadbala": "total and dig_bala in shashtiamshas (60 = 1 rupa); rupas = total/60",
    "sign_index": "0-based, Aries=0 ... Pisces=11 (D1 and every varga)",
    "varga_dignity": "sign-level dignity in the varga: exalted, debilitated, own_sign, friend, enemy, neutral"
  },
  "included": [
    "shadbala",
    "bhavabala"
  ],
  "vargas": [
    "D9"
  ],
  "lagna": {
    "sign_index": 10,
    "deg_in_sign": 26.391667,
    "sidereal_lon": 326.391667,
    "nakshatra_idx": 24,
    "pada": 2,
    "lord": "saturn",
    "nakshatra_lord": "jupiter"
  },
  "planets": [
    {
      "id": "sun",
      "sign_index": 9,
      "deg_in_sign": 1.063319,
      "sidereal_lon": 271.063319,
      "house": 12,
      "nakshatra_idx": 20,
      "pada": 2,
      "nakshatra_lord": "sun",
      "speed": 1.018256,
      "is_retro": false,
      "is_combust": false,
      "dignity": "enemy",
      "is_debilitated": false,
      "neecha_bhanga": false,
      "vargottama": true,
      "lord_of": [
        7
      ],
      "shadbala": {
        "rupas": 5.81,
        "total": 348.61,
        "required_min": 390,
        "is_strong": false,
        "dig_bala": 49.37
      },
      "avastha": {
        "baladi": "Mrita",
        "jagradadi": "Sushupta",
        "deeptadi": "Vikala"
      },
      "varga": {
        "D9": {
          "sign_index": 9,
          "house": 9,
          "dignity": "enemy"
        }
      }
    },
    {
      "id": "moon",
      "sign_index": 4,
      "deg_in_sign": 20.127289,
      "sidereal_lon": 140.127289,
      "house": 7,
      "nakshatra_idx": 10,
      "pada": 3,
      "nakshatra_lord": "venus",
      "speed": 12.579355,
      "is_retro": false,
      "is_combust": false,
      "dignity": "friend",
      "is_debilitated": false,
      "neecha_bhanga": false,
      "vargottama": false,
      "lord_of": [
        6
      ],
      "shadbala": {
        "rupas": 8.15,
        "total": 489.17,
        "required_min": 360,
        "is_strong": true,
        "dig_bala": 33.02
      },
      "avastha": {
        "baladi": "Vriddha",
        "jagradadi": "Swapna",
        "deeptadi": "Pramudita"
      },
      "varga": {
        "D9": {
          "sign_index": 6,
          "house": 6,
          "dignity": "neutral"
        }
      }
    }
  ],
  "houses": [
    {
      "house": 1,
      "sign_index": 10,
      "lord": "saturn",
      "sav": 28,
      "bhava_bala": 379.77,
      "occupants": [],
      "aspected_by": [
        "moon",
        "mars"
      ]
    },
    {
      "house": 2,
      "sign_index": 11,
      "lord": "jupiter",
      "sav": 24,
      "bhava_bala": 534.19,
      "occupants": [],
      "aspected_by": [
        "ketu"
      ]
    }
  ],
  "shadbala_version": "v2_bphs",
  "sav_total": 337,
  "karakas": {
    "scheme": "saptagraha",
    "atmakaraka": {
      "planet": "mars",
      "deg_in_sign": 25.98352
    },
    "amatyakaraka": {
      "planet": "saturn",
      "deg_in_sign": 23.562164
    },
    "bhratrukaraka": {
      "planet": "moon",
      "deg_in_sign": 20.127289
    },
    "matrukaraka": {
      "planet": "mercury",
      "deg_in_sign": 17.843241
    },
    "putrakaraka": {
      "planet": "jupiter",
      "deg_in_sign": 9.682402
    },
    "gnatikaraka": {
      "planet": "venus",
      "deg_in_sign": 7.14048
    },
    "darakaraka": {
      "planet": "sun",
      "deg_in_sign": 1.063319
    }
  },
  "avakhada": {
    "varna": "Kshatriya",
    "vashya": "Vanchar",
    "yoni": "Mushaka",
    "gana": "Manushya",
    "nadi": "Madhya",
    "paya": "Silver",
    "tatva": "Prithvi",
    "rajju": "Kati",
    "nakshatra_lord": "venus",
    "birth_stone": "Diamond",
    "lucky_numbers": [
      6,
      7
    ],
    "lucky_day": "Friday",
    "lucky_color": "White"
  },
  "skipped": {
    "planets.ketu.shadbala": "shadbala is defined for the seven grahas only",
    "planets.rahu.shadbala": "shadbala is defined for the seven grahas only"
  }
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
date, time, tz, location	string / object	Birth details you sent (unprefixed `date`, `time`, `tz`, `lat`, `lon`), echoed back. `time` is "12:00" when you leave it out. example: `"1990-01-15", "10:30", "Asia/Kolkata"`
ayanamsa, ayanamsa_value	string, number	Ayanamsa used (default lahiri) and its value in degrees at the birth moment. example: `"lahiri", 23.71795`
house_system	string	Always whole_sign: every `house` here is counted by whole signs from the lagna. example: `"whole_sign"`
conventions	object	The units and index conventions of this response, spelled out in the response itself. example: `{ "sign_index": "0-based, Aries=0 ... Pisces=11 (D1 and every varga)", … }`
included, vargas	string[]	Optional sections that were computed (`include`, default all except yogas) and the vargas returned under planets[].varga (`vargas`, default D9). example: `["shadbala", "bhavabala", …], ["D9"]`
lagna	object	Ascendant: sign, degree in sign, sidereal longitude, nakshatra, pada, sign lord and nakshatra lord. example: `{ "sign_index": 10, "deg_in_sign": 26.391667, "nakshatra_idx": 24, "pada": 2, "lord": "saturn", … }`
planets[]	array (9 items)	One row per graha, sun to ketu. example: `[{ "id": "sun", … }, …]`
planets[].sign_index, deg_in_sign, sidereal_lon, house	integer, number, number, integer	Sign (0-based), degree within the sign, sidereal longitude and whole-sign house (1-based). example: `9, 1.063319, 271.063319, 12`
planets[].nakshatra_idx, pada, nakshatra_lord	integer, integer, string	Nakshatra (0-based), pada (1–4) and nakshatra lord. example: `20, 2, "sun"`
planets[].is_retro, is_combust, dignity, is_debilitated, neecha_bhanga, vargottama	boolean / string	Same values as /v1/chart/planets, /v1/chart/combustion and /v1/chart/dignity, plus neecha bhanga and vargottama (same sign in D1 and D9). example: `false, false, "enemy", false, false, true`
planets[].lord_of	integer[]	Houses whose sign this graha rules. example: `[7]`
planets[].shadbala	object	Shadbala total in shashtiamshas (60 = 1 rupa), the classical minimum and whether it is met. Seven grahas only; Rahu and Ketu are listed in skipped. example: `{ "rupas": 5.81, "total": 348.61, "required_min": 390, "is_strong": false, "dig_bala": 49.37 }`
planets[].avastha	object	Baladi, Jagradadi and Deeptadi avasthas. example: `{ "baladi": "Mrita", "jagradadi": "Sushupta", "deeptadi": "Vikala" }`
planets[].varga	object	Placement in each requested varga: sign, house from the varga lagna and sign-level dignity. example: `{ "D9": { "sign_index": 9, "house": 9, "dignity": "enemy" } }`
houses[]	array (12 items)	Each whole-sign house: sign, lord, Sarvashtakavarga bindus, bhava bala, occupants and the grahas aspecting it. example: `[{ "house": 1, "sign_index": 10, "lord": "saturn", "sav": 28, "bhava_bala": 379.77, "occupants": [], "aspected_by": ["moon", "mars"] }, …]`
sav_total, shadbala_version	integer, string	Sum of SAV bindus (always 337) and the shadbala method version. example: `337, "v2_bphs"`
karakas	object	Jaimini chara karakas, 7-karaka scheme (Atmakaraka to Darakaraka). example: `{ "scheme": "saptagraha", "atmakaraka": { "planet": "mars", "deg_in_sign": 25.98352 }, … }`
avakhada	object	Avakhada chakra, as /v1/chart/avakhada. example: `{ "varna": "Kshatriya", "yoni": "Mushaka", "gana": "Manushya", "nadi": "Madhya", … }`
skipped	object	Every field that could not be computed, as {field: reason}. Empty object when nothing was skipped. example: `{ "planets.rahu.shadbala": "shadbala is defined for the seven grahas only" }`

Usage tips

How to use it

Replace many calls
The default call (D9, no yogas) replaces planets, ascendant, houses, dignity, combustion, house-occupants, aspects, shadbala, bhavabala, ashtakvarga, avakhada and divisional/D9 — about 180 credits of separate calls — for 50 credits.
Choose sections and vargas
include takes a comma list (shadbala, bhavabala, ashtakvarga, aspects, avastha, karakas, avakhada, yogas, all). vargas takes up to 16 of D2…D60 (or names such as navamsa); D1 is rejected because the planets already carry it.
Build your own reading
Because everything is ids and numbers, you can render the chart, drive your own rule engine or feed an LLM prompt without parsing text. Map sign_index, nakshatra_idx and planet ids to names in your own language.
Read skipped
Fields that cannot be computed (for example shadbala for Rahu and Ketu) are absent from the rows and listed in skipped, so a missing key is never silent.

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 7,500 welcome credits plus 1,500 free credits a month. Sign up.