Varshaphal Planets Extended API

Varshaphal Planets Extended

Returns an enriched planetary dataset for a Varshaphal (Solar Return) chart, providing all the data of the standard Varshaphal Planets endpoint plus additional computed attributes needed for advanced annual horoscope analysis. This endpoint is designed for applications and practitioners that require deeper planetary metrics beyond basic sign and house placements.

What This API Does

Building on the same Varshaphal calculation engine — which casts a solar return chart at the exact moment the Sun returns to its natal degree in the target year — this endpoint returns an extended planetary profile for each planet in the Varshaphal chart. In addition to the core positional data, it computes supplementary attributes such as Tajika-specific strengths, aspectual relationships, and other advanced metrics used in the Tajika (annual horoscope) system of Vedic astrology. The chart is cast for the individual's current location in the target year, reflecting where they are living rather than where they were born.

Data Returned

The response includes all standard Varshaphal planetary data plus extended attributes for each planet:

• Planet name and position — zodiac sign, degree, minute, and second of arc at the moment of solar return

• Retrograde status — whether the planet is in retrograde motion at the time of the solar return

• House placement — the house the planet occupies in the Varshaphal chart based on the current location

• Nakshatra — the lunar mansion and pada (quarter) the planet occupies

• Dignity and strength indicators — sign-based dignity (exaltation, debilitation, own sign, etc.) in the solar return chart

• Extended Tajika attributes — additional computed values such as Tajika aspects (Ithasala, Ishrafa, etc.), planetary war status, combustion status, and other Tajika-specific strength measures used in annual horoscope interpretation

• Relationship to natal positions — comparative data showing how the Varshaphal planet positions relate to the natal chart placements

Main Use Cases

• Advanced annual horoscope analysis — providing the full planetary dataset required for a complete Tajika-system interpretation, including aspect analysis and strength assessment

• Jyotish practitioners specializing in Varshaphal — accessing all computed Tajika metrics in a single call, eliminating the need to derive secondary attributes manually

• Feature-rich astrology platforms — powering detailed annual forecast modules that display extended planetary data, Tajika aspects, and strength tables alongside the solar return chart

• Research and comparative tools — enabling in-depth study of Varshaphal techniques by exposing the full computed attribute set for each planet

• Automated report generation — supplying the complete data layer needed to generate comprehensive, practitioner-grade annual horoscope reports programmatically

Key Functionality

• Returns all data from the standard Varshaphal Planets endpoint plus additional Tajika-specific computed attributes, making it a strict superset suitable for any use case that would otherwise use the standard endpoint

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

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

• Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header for compatibility with different Vedic astrology traditions

• Provides Tajika aspect data (e.g., Ithasala — applying conjunction indicating fruition, Ishrafa — separating aspect indicating past events) that are central to annual horoscope prediction in the Tajika system

• Designed for localization — the Accept-Language header controls the language of descriptive content in the response

• Intended for use alongside other Varshaphal endpoints (houses, yogas, Muntha, etc.) as the extended planetary data layer for a complete and detailed annual horoscope