Skip to main content
POST/v1/astro/strength

Calculate planetary strength suite

Builds a composite strength report including shadbala, divisional charts, ashtakavarga, and karakas from birth input. Requires authenticated API key access (Vedic tier or above in product terms). Returns a unified strength payload for all supported modules.

Request parameters

locationoptional
string | null
City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
nameoptional
string
Person name associated with the birth record
daterequired
string
Birth date in YYYY-MM-DD format
timeoptional
string | null
Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudeoptional
number | null
Latitude. Required if location not provided.
longitudeoptional
number | null
Longitude. Required if location not provided.
timezoneoptional
string | null
IANA timezone. Required if location not provided.
ayanamsaoptional
string
Sidereal ayanamsa mode used in calculations

Response fields

success
boolean
True if the request succeeded
message
string
Human-readable status message
data
object
Strength report root. Includes shadbala, bhavbala (keys "1""12" with bhavadhipati_bala, bhava_dig_bala, bhava_drik_bala, total), vimshopaka_bala (per-planet sixteen-varga score and threshold), divisional_charts, ashtakavarga, karakas, birth_time_provided, and optional graha_yuddha.

Errors

Missing or invalid API key.
Upstream ephemeris service error.
API key tier does not include this endpoint.
Unexpected server error.
Too many requests in a short window.
Request body exceeds the size limit.
Referenced resource was not found.
Request body failed schema validation.