POST · VEDIC

Chalit

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

Returns chart image URLs for the Bhava Chalit (Placidus) chart. In the Placidus system, house cusps are calculated using the time it takes each degree to rise, producing unequal house sizes. Planets can shift houses compared to the Rashi chart — essential for prediction work in KP and modern Parashari.

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

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 CHALIT.
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 — Chalit — house cusp data, boundaries, angles (ASC/MC/DSC/IC), planets per house
  • Bhava — Equal House system chart
  • Sripati — Sripati mid-point house system chart
  • Varga — any D1–D60 chart image