Varshaphal Year Chart Extended API

Varshaphal Year Chart Extended

Generates a rendered chart image for a Varshaphal (Solar Return) horoscope with an extended dual-chart layout, displaying both the Varshaphal solar return chart and the natal birth chart together in a single visual output. This endpoint is designed for applications and practitioners that need to present both charts side by side for comparative annual horoscope analysis.

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 both the natal chart and the Varshaphal solar return chart and renders them together as a combined chart diagram. The Varshaphal chart is cast at the exact moment the Sun returns to its natal degree in the target year, using the current location to determine the house framework. The extended layout renders both charts in a single image, enabling direct visual comparison of natal and annual planetary positions — a standard presentation format in Varshaphal consultations.

Data Returned

The response returns a rendered extended Varshaphal chart image, which includes:

• Dual chart layout — both the natal birth chart and the Varshaphal solar return chart rendered together in a single diagram

• Planetary placements for both charts — all planets displayed in their respective houses and signs for both the natal and Varshaphal configurations

• Ascendant and house cusps for both charts — the natal Lagna and Varshaphal Lagna rendered within their respective chart sections

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

• Visual styling — the combined chart rendered with the specified background color, line colors, font sizes, and other display parameters applied consistently across both chart sections

Main Use Cases

• Jyotish practitioners — generating a single printable or shareable diagram that shows both the natal and Varshaphal charts for client consultations, eliminating the need to present two separate images

• Astrology apps and platforms — embedding a combined natal and annual chart view directly into year-ahead forecast screens or annual report features

• PDF and automated report generation — incorporating a dual-chart layout into horoscope report pipelines for a professional, practitioner-standard presentation

• Comparative annual analysis tools — enabling users to visually track how planetary positions shift between the natal chart and each year's solar return chart

• Educational tools — illustrating the Varshaphal technique by showing how the annual chart overlays and relates to the natal chart

Key Functionality

• Renders both the natal chart and the Varshaphal solar return chart in a single combined image, which is the standard presentation format for Varshaphal consultations in the Tajika system

• Accepts both birth location and current location separately — birth data anchors the natal chart, while current latitude, longitude, and timezone determine where the Varshaphal chart is cast

• 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 applied consistently to both chart sections in the combined layout

• Accepts visual customization parameters — background color, inner and outer line colors, sign and planet colors, font sizes, line widths, and symbol styles for 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 standard Varshaphal Year Chart endpoint: use that endpoint when only the solar return chart is needed, and this endpoint when a combined natal and Varshaphal dual-chart layout is required