POST · VEDIC

Varshphal Chart

Endpoint POST https://starsapi.com/api/v3/vedic/varshphal/chart

Returns Varshphal chart data with images — rendered chart images (North and South Indian styles) for the solar return chart.

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.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone identifier.
varshphal_yearintegerYes*Calendar year for the annual chart. Alternatively send year_of_life.
year_of_lifeintegerYes*Year of life. Send either this or varshphal_year, not both.
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.

Response shape

resolved

Present in all Varshphal endpoints.

FieldTypeDescription
year_of_lifeintegerWhich year of life.
varshphal_yearintegerCalendar year.
completed_yearsintegerCompleted years of age.
solar_return_datestringSolar return date (YYYY-MM-DD).
statusstringcurrent, past, or future.
status_messagestringHuman-readable summary.

charts

Contains chart image URLs for the Varshphal D1 (Rashi) and D9 (Navamsa) charts, both North and South Indian styles. URLs are signed and time-limited.

Image URLs are time-limited. Each contains an expires timestamp and token. Fetch directly without API key. Returns 403 after expiry.

Use cases

  • Chart display — embed annual chart images directly in your app.
  • PDF reports — download chart images for annual prediction reports.
  • North vs South — both styles always returned.

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.
400INVALID_PARAMBad varshphal_year or year_of_life.
405METHOD_NOT_ALLOWEDNon-POST request.

See also