/v1/chart/dignity

Planetary dignity (exalted, debilitated, own sign, etc).

What this tells you

Dignity describes how "at home" a planet is in the sign it occupies. A planet in exaltation or own sign delivers its karaka significations fully; a debilitated planet struggles to do so. This is the first-order strength assessment — /v1/chart/shadbala gives the quantitative breakdown.

Request

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

example request

curl "https://api.divyastroapi.com/v1/chart/dignity?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "planets": [
    { "name": "Sun",     "sign": "Capricorn",   "dignity": "neutral",       "is_exalted": false, "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false },
    { "name": "Moon",    "sign": "Taurus",      "dignity": "exalted",       "is_exalted": true,  "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false },
    { "name": "Mars",    "sign": "Scorpio",     "dignity": "own_sign",      "is_exalted": false, "is_debilitated": false, "is_own_sign": true,  "is_moolatrikona": false },
    { "name": "Mercury", "sign": "Sagittarius", "dignity": "enemy",         "is_exalted": false, "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false },
    { "name": "Jupiter", "sign": "Cancer",      "dignity": "exalted",       "is_exalted": true,  "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false },
    { "name": "Venus",   "sign": "Sagittarius", "dignity": "neutral",       "is_exalted": false, "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false },
    { "name": "Saturn",  "sign": "Capricorn",   "dignity": "own_sign",      "is_exalted": false, "is_debilitated": false, "is_own_sign": true,  "is_moolatrikona": false }
  ]
}

Field reference

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

Field	Type	Meaning
planets[].dignity	string	Overall status in the sign it occupies. example: `"exalted"`
planets[].is_exalted	boolean	Planet in its exaltation sign — strongest. example: `true`
planets[].is_debilitated	boolean	Planet in its debilitation sign — weakest. example: `false`
planets[].is_own_sign	boolean	Planet in one of its own signs. example: `true`
planets[].is_moolatrikona	boolean	Planet in its moolatrikona (a specific degree range in its own sign — particularly strong). example: `false`

Usage tips

How to use it

Highlight in chart UI
Color or badge exalted/debilitated planets prominently. Users care about these at first glance.
Use with cancel rules
Debility can be canceled (Neecha Bhanga) by specific placements. If your app shows a debilitated planet, also query its cancel status.

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://divyastroapi.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 500 free credits. Sign up.