/v1/chart/ashtakvarga/{planet}

Bhinna Ashtakavarga for one planet.

What this tells you

Bhinna Ashtakavarga for a single planet — more detailed than the summary view in /v1/chart/ashtakvarga. Use when your UI focuses on one planet at a time (e.g. "Jupiter's transit map for 2027").

Request

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

example request

curl "https://api.divyastroapi.com/v1/chart/ashtakvarga/sun?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

{
  "planet": "Jupiter",
  "bindus": [5, 4, 6, 7, 5, 5, 4, 5, 5, 5, 4, 5],
  "bindus_total": 56,
  "classical_total": 56,
  "signs": [
    { "sign": "Aries",       "index":  1, "bindus": 5 },
    { "sign": "Taurus",      "index":  2, "bindus": 4 },
    { "sign": "Gemini",      "index":  3, "bindus": 6 },
    { "sign": "Cancer",      "index":  4, "bindus": 7 }
  ]
}

Field reference

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

Field	Type	Meaning
planet	string	Planet requested (path param). example: `"Jupiter"`
bindus	integer[12]	Bhinna bindu count per sign. example: `[5, 4, 6, …]`
bindus_total	integer	Sum of the array. example: `56`
classical_total	integer	Expected total per classical texts. Sun=48, Moon=49, Mars=39, Mercury=54, Jupiter=56, Venus=52, Saturn=39. example: `56`
signs	array of 12	Bindus broken down by sign name for display. example: `[…]`

Usage tips

How to use it

Valid planets
sun, moon, mars, mercury, jupiter, venus, saturn. Rahu/Ketu are not part of Ashtakavarga.

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.