/v1/chart/shadbala

Six-fold strength for all planets.

What this tells you

Shadbala ("six-fold strength") is the most rigorous quantitative strength measure in Vedic astrology — described in Brihat Parashara Hora Shastra. A planet must score above its required threshold to deliver full results; below that, significations weaken. Each of 6 components captures a different dimension of strength.

Shadbala costs 3 credits — it's the most compute-heavy chart endpoint. Cache per birth.

Request

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

example request

curl "https://api.divyastroapi.com/v1/chart/shadbala?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",
      "total_virupa": 381.45,
      "total_rupa":     6.36,
      "required_rupa":  6.50,
      "is_sufficient":  false,
      "components": {
        "sthana_bala":     { "virupa":  82.18, "rupa": 1.37, "breakdown": { "uccha": 0.0, "sapthavargaja": 38.18, "ojha_yugma": 30.0, "kendradi": 14.0, "drekkana": 0.0 } },
        "dik_bala":        { "virupa":  48.22, "rupa": 0.80 },
        "kala_bala":       { "virupa":  89.05, "rupa": 1.48, "breakdown": { "nathonnatha": 30.0, "paksha": 0.0, "tribhaga": 60.0, "abda": 0.0, "masa": 0.0, "vara": 0.0, "hora": 0.0, "ayana": -0.95 } },
        "cheshta_bala":    { "virupa":  30.15, "rupa": 0.50 },
        "naisargika_bala": { "virupa":  60.00, "rupa": 1.00 },
        "drik_bala":       { "virupa":  71.85, "rupa": 1.20 }
      }
    }
  ],
  "notes": "All planet objects follow the same shape (Moon, Mars, Mercury, Jupiter, Venus, Saturn)."
}

Field reference

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

Field	Type	Meaning
planets[].total_virupa	number	Sum of all 6 component balas in virupas. 1 rupa = 60 virupas. example: `381.45`
planets[].total_rupa	number	Total Shadbala in rupas (virupa / 60). example: `6.36`
planets[].required_rupa	number	Classical minimum required rupa for this planet. Sun: 6.5, Moon: 6.0, Mars: 5.0, Mercury: 7.0, Jupiter: 6.5, Venus: 5.5, Saturn: 5.0. example: `6.50`
planets[].is_sufficient	boolean	Whether total_rupa >= required_rupa. Insufficient Shadbala means the planet struggles to deliver its results. example: `false`
planets[].components.sthana_bala	object	Positional strength (exaltation, own sign, Saptavargaja, etc.). example: `…`
planets[].components.dik_bala	object	Directional strength (Sun/Mars in 10th, Jupiter/Mercury in 1st, etc.). example: `…`
planets[].components.kala_bala	object	Temporal strength (day/night, paksha, year, month, day, hour). example: `…`
planets[].components.cheshta_bala	object	Motional strength (retrograde, direct motion speed). example: `…`
planets[].components.naisargika_bala	object	Natural strength (fixed per planet: Sun strongest, Saturn weakest). example: `…`
planets[].components.drik_bala	object	Aspectual strength (benefic vs malefic aspects received). example: `…`

Usage tips

How to use it

Render as a bar chart
Show each planet's total_rupa as a bar, with the required_rupa as a threshold line. Color red if insufficient.
Components matter for diagnostics
A planet may have high total but weak kala_bala (born at a bad time-of-day for it). Expose the component breakdown so advanced users can dig in.

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.