SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Planets Extended API provides Varshaphal related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/varshaphal/planets/extended
en
hi
ma
Methodology and astrological context for 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.
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.
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
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
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
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
|
varshaphalYear
Optional
|
integer |
Varshaphal year.
Example:
2025
|
|
cLat
Required
|
float |
Current Latitude of the birth location.
Example:
28.6139
|
|
cLon
Required
|
float |
Current Longitude of the birth location.
Example:
77.1025
|
|
cTzone
Optional
|
float |
Current Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Varshaphal Planets Extended.
The Varshaphal Planets Extended API provides authentic Varshaphal calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Varshaphal Planets Extended API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Varshaphal Planets Extended consumes 1 API credit. The endpoint delivers high performance with an average response time of ~78ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.