/v1/chart/astro-details

All-in-one birth chart snapshot: Avakhada + Ascendant + all planets + birth panchang (tithi/nakshatra/yoga/vara) + sun/moon sign — replaces 3 separate calls.

What this tells you

`astro-details` is the all-in-one birth chart snapshot. In a single 30-credit call you get: the Avakhada Chakra, the ascendant, all 9 planet positions (with `sign_index`, `nakshatra_idx`, `nak_lord`, `deg_in_sign`, `house`, `is_retro`, `speed`), sun and moon signs, and the panchang at the birth moment (tithi, nakshatra, yoga, vara). It replaces separate calls to /v1/chart/avakhada, /v1/chart/ascendant and /v1/chart/planets. Name strings are translated with `locale`.

Request

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

example request

curl "https://api.lifeastroapi.com/v1/chart/astro-details?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`	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.

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",
  "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"
  },
  "ascendant": {
    "sidereal_lon": 326.391667,
    "sign_index": 10,
    "deg_in_sign": 26.391667,
    "dms_in_sign": "26°23'30\"",
    "nakshatra_idx": 24,
    "pada": 2,
    "nak_lord": "Jupiter",
    "mc": 239.182315,
    "house_system": "whole_sign"
  },
  "planets": [
    {
      "id": "sun",
      "name": "Sun",
      "sidereal_lon": 271.063319,
      "sign_index": 9,
      "deg_in_sign": 1.063319,
      "dms_in_sign": "01°03'47\"",
      "house": 12,
      "nakshatra_idx": 20,
      "pada": 2,
      "nak_lord": "Sun",
      "speed": 1.018256,
      "is_retro": false,
      "ecl_lat": -0.000088
    },
    {
      "id": "moon",
      "name": "Moon",
      "sidereal_lon": 140.127289,
      "sign_index": 4,
      "deg_in_sign": 20.127289,
      "dms_in_sign": "20°07'38\"",
      "house": 7,
      "nakshatra_idx": 10,
      "pada": 3,
      "nak_lord": "Venus",
      "speed": 12.579355,
      "is_retro": false,
      "ecl_lat": -2.411875
    }
  ],
  "sun_sign_index": 9,
  "sun_sign": "Capricorn",
  "moon_sign_index": 4,
  "moon_sign": "Leo",
  "birth_panchang": {
    "tithi_index": 19,
    "tithi_name": "Panchami",
    "tithi_paksha": "Krishna",
    "tithi_deity": "Naga",
    "tithi_type": "Purna",
    "nakshatra_index": 10,
    "nakshatra_name": "Purva Phalguni",
    "nakshatra_pada": 3,
    "nakshatra_lord": "Venus",
    "yoga_index": 3,
    "yoga_name": "Saubhagya",
    "vara_index": 1,
    "vara": "Monday",
    "vara_lord": "Moon"
  }
}

Field reference

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

Field	Type	Meaning
date	string	Birth date you sent (YYYY-MM-DD), echoed back. example: `"1990-01-15"`
time	string	Birth time you sent, echoed back. "12:00" when you leave `time` out. example: `"10:30"`
tz	string	Timezone you sent (IANA name or fixed offset such as +05:30), echoed back. example: `"Asia/Kolkata"`
location	object	Birth coordinates used. `alt` is in metres and is 0 unless you send `alt`. example: `{ "lat": 19.076, "lon": 72.8777, "alt": 0 }`
ayanamsa	string	Ayanamsa used. Default lahiri; set it with the `ayanamsa` parameter (lahiri, raman, krishnamurti, fagan, yukteshwar, true_chitrapaksha). example: `"lahiri"`
ayanamsa_value	number	Ayanamsa in degrees at the birth moment. Sidereal longitude = tropical longitude − this value. example: `23.71795`
house_system	string	Echo of the optional `house_system` parameter (default whole_sign). This endpoint does not use it, so you never need to send it; only /v1/chart/houses changes with it. Planet `house` numbers here are always whole-sign. example: `"whole_sign"`
avakhada	object	Avakhada Chakra from the birth Moon: varna, vashya, yoni, gana, nadi, paya, tatva, rajju, nakshatra_lord, birth_stone, lucky_numbers, lucky_day, lucky_color. Same object as /v1/chart/avakhada. example: `{ "varna": "Kshatriya", "vashya": "Vanchar", … }`
ascendant	object	The lagna. Same object as /v1/chart/ascendant: sidereal_lon, sign_index, deg_in_sign, dms_in_sign, nakshatra_idx, pada, nak_lord, mc, house_system. example: `{ "sidereal_lon": 326.391667, … }`
ascendant.sign_index	integer (0–11)	Lagna sign: 0=Aries, …, 11=Pisces. example: `10`
ascendant.nak_lord	string	Vimshottari lord of the lagna nakshatra. example: `"Jupiter"`
planets[]	array of 9 objects	All 9 grahas, Sun to Ketu. Same objects as /v1/chart/planets: id, name, sidereal_lon, sign_index, deg_in_sign, dms_in_sign, house, nakshatra_idx, pada, nak_lord, speed, is_retro. example: `[{ "id": "sun", "name": "Sun", … }, …]`
planets[].sign_index	integer (0–11)	Sign index (no sign name field — use sign_index for chart rendering). example: `9`
planets[].house	integer (1–12)	Whole-sign house from the ascendant. example: `12`
sun_sign_index	integer (0–11)	Sidereal sign of the Sun (Surya rashi), 0=Aries. example: `9`
sun_sign	string	Name of that sign. Translated with `locale`. example: `"Capricorn"`
moon_sign_index	integer (0–11)	Sidereal sign of the Moon (Chandra rashi), 0=Aries. example: `4`
moon_sign	string	Name of that sign. Translated with `locale`. example: `"Leo"`
birth_panchang	object	Panchang at the exact birth moment (not at sunrise). example: `{ "tithi_index": 19, … }` Jyotish: Birth panchang is used in naming ceremonies (Naamkaran), the first rice ceremony, and general birth chart analysis.
birth_panchang.tithi_index	integer (0–29)	Tithi running at birth, 0-based: 0–14 = Shukla Pratipada to Purnima, 15–29 = Krishna Pratipada to Amavasya. example: `19`
birth_panchang.tithi_name	string	Tithi name. example: `"Panchami"`
birth_panchang.tithi_paksha	string	Shukla or Krishna. example: `"Krishna"`
birth_panchang.tithi_deity	string	Presiding deity of the tithi. example: `"Naga"`
birth_panchang.tithi_type	string	Tithi group: Nanda, Bhadra, Jaya, Rikta or Purna. example: `"Purna"`
birth_panchang.nakshatra_index	integer (0–26)	Moon nakshatra at birth: 0=Ashwini, …, 26=Revati. example: `10`
birth_panchang.nakshatra_name	string	Nakshatra name. example: `"Purva Phalguni"`
birth_panchang.nakshatra_pada	integer (1–4)	Pada of the Moon nakshatra. example: `3`
birth_panchang.nakshatra_lord	string	Vimshottari lord of the nakshatra. example: `"Venus"`
birth_panchang.yoga_index	integer (0–26)	Yoga at birth, 0-based: 0=Vishkumbha, …, 26=Vaidhriti. example: `3`
birth_panchang.yoga_name	string	Yoga name. example: `"Saubhagya"`
birth_panchang.vara_index	integer (0–6)	Weekday: 0=Sunday, 1=Monday, …, 6=Saturday. example: `1`
birth_panchang.vara	string	Calendar weekday of the birth moment in the request `tz`. It is not moved back for a birth before sunrise. example: `"Monday"`
birth_panchang.vara_lord	string	Planet that rules the weekday. example: `"Moon"`

Usage tips

How to use it

First call for any kundli app
Call astro-details immediately after a user enters their birth data. You get everything needed to render a basic kundli card — planets, avakhada, and birth panchang — without planning multiple calls.
Birth panchang for naming apps
Use `birth_panchang.nakshatra_name`, `birth_panchang.nakshatra_pada` and `birth_panchang.nakshatra_lord` for naming ceremony apps and baby name suggestions.
Indexes start at 0
`tithi_index`, `nakshatra_index`, `yoga_index` and `vara_index` are all 0-based. Add 1 if you show them as ordinal numbers.

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.