Varshaphal Year Chart API

Varshaphal Year Chart

Generates a rendered chart image for a Varshaphal (Solar Return) horoscope — a Vedic annual chart cast at the exact moment the Sun returns to its natal degree in the target year. This endpoint combines the astrological computation of the solar return with chart rendering, returning a visual representation of the Varshaphal chart ready for display in applications, reports, or client-facing interfaces.

What This API Does

This endpoint accepts the individual's birth details, their current geographic location for the target year, and the desired Varshaphal year, then computes the solar return chart and renders it as a visual chart diagram. The chart is cast using the Vedic Varshaphal (Tajika) system, placing planets in their solar return positions within the house framework determined by the current location. The rendered output reflects the chart style, color scheme, and display preferences specified in the request, making it suitable for direct embedding in user interfaces or PDF reports without additional rendering work on the client side.

Data Returned

The response returns a rendered Varshaphal chart, which includes:

• Chart image — a visual diagram of the Varshaphal solar return chart in the requested style (North Indian, South Indian, or East Indian format)

• Planetary placements — all planets displayed in their respective houses and signs within the chart diagram

• Ascendant and house cusps — the Varshaphal Lagna (ascendant) and house divisions rendered within the chart

• Sign and planet labels — zodiac signs and planet symbols or abbreviations rendered according to the specified symbol and language preferences

• Visual styling — chart rendered with the specified background color, line colors, font sizes, and other display parameters

Main Use Cases

• Astrology apps and platforms — embedding a ready-to-display Varshaphal chart image directly into annual forecast screens or user dashboards

• Jyotish practitioners — generating printable or shareable Varshaphal chart diagrams for client reports and consultations

• PDF and report generation — incorporating a rendered annual chart into automated horoscope report pipelines without client-side chart rendering

• Comparative chart displays — showing the Varshaphal chart alongside the natal chart for year-ahead analysis

• Educational and demonstration tools — visually illustrating how the solar return chart shifts year to year based on current location

Key Functionality

• Accepts both birth location and current location separately — birth data anchors the natal chart calculation, while current latitude, longitude, and timezone determine where the Varshaphal chart is cast, reflecting the individual's place of residence in the target year

• Accepts a target Varshaphal year (varshaphalYear) to render the solar return chart for any past, present, or future year

• Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header for sidereal calculations aligned with the practitioner's tradition

• Supports multiple chart styles — North Indian, South Indian, and East Indian chart formats to match regional practitioner and user preferences

• Accepts visual customization parameters — background color, inner and outer line colors, sign and planet colors, font sizes, line widths, and symbol styles, enabling seamless integration with the host application's design language

• Designed for localization — the Accept-Language header controls the language used for labels and text within the rendered chart

• Complements the Varshaphal Planets and Varshaphal Planets Extended endpoints: use those for raw planetary data and this endpoint when a rendered visual chart output is required