/v1/prashna/lagna-lord

Prashna lagna lord.

What this tells you

The Prashna lagna lord stands for the querent. Its house, dignity and condition (retrograde, combust) show the state of the person asking and the likely outcome. The response does not include the ascendant itself; get it from /v1/prashna/chart.

Pass the question moment as `date`, `time`, `tz` and the querent's place as `lat`, `lon` (all required except `time`, which defaults to 12:00).

Request

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

example request

curl "https://api.lifeastroapi.com/v1/prashna/lagna-lord?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.

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

{
  "planet": "Saturn",
  "sign_idx": 8,
  "sign": "Sagittarius",
  "house": 11,
  "dignity": "neutral",
  "is_strong": false,
  "is_retro": false,
  "is_combust": true
}

Field reference

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

Field	Type	Meaning
planet	string	Lord of the Prashna ascendant sign (traditional rulers; Rahu and Ketu are never lords). Localised with `locale`. example: `"Saturn"`
sign_idx	integer (0–11)	Sign the lord occupies (0 = Aries). Note the key is `sign_idx`, not `sign_index`. example: `8`
sign	string	Name of that sign. Localised with `locale`. example: `"Sagittarius"`
house	integer (1–12)	Whole-sign house of the lord, counted from the Prashna ascendant. example: `11`
dignity	string	exalted, debilitated, own, moolatrikona, friendly, enemy or neutral, by sign (friendly/enemy use natural friendship with the sign lord). Localised with `locale`. example: `"neutral"`
is_strong	boolean	True when dignity is exalted, own or moolatrikona and the lord is neither retrograde nor combust. example: `false`
is_retro	boolean	Lord is retrograde. example: `false`
is_combust	boolean	Lord is within its combustion orb of the Sun: Moon 12°, Mars 17°, Mercury 14°, Jupiter 11°, Venus 10°, Saturn 15°. Always false when the lord is the Sun. example: `true`

Usage tips

How to use it

First data point in any Prashna UI
Display it before drawing the full chart.
Same inputs as the answer
/v1/prashna/answer uses this lagna lord (house, dignity, combustion) in its scoring.

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.