POST/v1/astro/strength
Calculate planetary strength suite
Builds a composite strength report including shadbala, divisional charts, ashtakavarga, and karakas from birth input. 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 (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
utc_offsetoptional
string | null
Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset
timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.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. Shadbala follows B.V. Raman's worked example and Jagannatha Hora: the Sun's and the Moon's cheshta_bala is 0, because BPHS's Cheshta Bala for them (the Sun's Ayana, the Moon's Paksha) is counted in Kala Bala, where the Sun's ayana and the Moon's paksha are doubled (0–120). ayana uses the kranti (declination) of the planet's ecliptic longitude, true obliquity of date, latitude ignored, so it stays within 0–60 (0–120 for the doubled Sun). paksha takes each planet's nature in the chart (BPHS Ch.3, as in Jagannatha Hora): the Moon is benefic in Shukla paksha and malefic in Krishna paksha (so a waning Moon is strongest near Amavasya), Mercury follows his companions, Jupiter and Venus are benefic, the rest malefic. Vimshopaka threshold bands (BPHS Ch.45): extremely_auspicious (15 or more), good (10 or more), moderate (5 or more) and zero_capacity (below 5). Under BPHS scoring every varga earns at least a quarter of its weight (great enemy's sign), so the score is never below 5.0 and zero_capacity does not occur; it is kept in the set of values for compatibility.Errors
Invalid API key format.
API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.
The provided API key was not found. Verify the key in your Asterwise dashboard.
This API key has been revoked.
Too many requests per minute. Please slow down.
Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.
Too many requests from this IP address. Please slow down.
Monthly API call limit reached. Upgrade your plan to continue.
Request body exceeds maximum allowed size of 64KB.
Your subscription has expired. Please renew at asterwise.com/dashboard to continue.
The request couldn't be processed. See the 'details' field for specific field-level issues.