POST · VEDIC

Bhava

Endpoint POST https://starsapi.com/api/v3/vedic/charts/bhava

Returns chart image URLs for the Bhava (Equal House) chart. In the Equal House system, the ascendant degree sits at the mid-point of the 1st house, and each house spans exactly 30°. This is the traditional Vedic house system used in Parashari astrology.

For chart images of other systems, see /charts/chalit (Placidus) and /charts/sripati (Sripati mid-point). For house data (cusps, boundaries, angles, planet placements per house), use /houses/bhava.

Authentication

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Query?api_key=am_live_xxxxxxxxxxxx

Request body

FieldTypeRequiredDescription
yearintegerYesBirth year, 4-digit.
monthintegerYesBirth month, 112.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour format.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees, −90…90.
longitudenumberYesDecimal degrees, −180…180.
timezonestringYesIANA timezone identifier.
ayanamsastringNoDefault lahiri. Full list →
node_typestringNomean (default) or true.

Response shape

FieldTypeDescription
codestringAlways BHAVA.
namestringChart name.
significancestringSystem description.
house_systemstringHouse system used.
ascendant.signstringRising sign.
ascendant.sign_lordstringRuling planet.
ascendant.degree_dmsstringAscendant degree.
images.northstring (URL)North Indian style chart image.
images.southstring (URL)South Indian style chart image.
Image URLs are time-limited. Each contains an expires timestamp and token. Fetch directly without API key. Returns 403 after expiry.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEHour/minute/second out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
405METHOD_NOT_ALLOWEDNon-POST request.

See also

  • Houses — Bhava — house cusp data, boundaries, angles (ASC/MC/DSC/IC), planets per house
  • Chalit — Placidus house system chart
  • Sripati — Sripati mid-point house system chart
  • Varga — any D1–D60 chart image