SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Planets 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
en
hi
ma
Methodology and astrological context for Varshaphal Planets.
Returns the planetary positions for a specific Varshaphal (Solar Return) chart — a Vedic annual horoscope calculated for the exact moment the Sun returns to its natal degree in a given year. This endpoint computes the Varshaphal chart based on the individual's birth data and their current location for the target year, providing the foundational planetary data used in annual predictive analysis.
Varshaphal, also known as the Annual Horoscope or Tajika system, is a Vedic predictive technique that casts a new chart each year at the precise moment the Sun returns to the same zodiacal degree it occupied at birth. This solar return chart is interpreted alongside the natal chart to forecast themes, events, and influences for the coming year. This endpoint accepts the individual's birth details, their current geographic location (which determines where the solar return chart is cast), and the target Varshaphal year, then computes and returns the full planetary configuration for that year's solar return chart.
The response includes, for each planet in the Varshaphal chart:
Planet name and position — zodiac sign, degree, minute, and second of arc for each planet 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 the planet occupies, along with its pada (quarter)
Dignity and strength indicators — the planet's sign-based dignity (exaltation, debilitation, own sign, etc.) in the solar return chart
Annual horoscope generation — computing the planetary foundation for a full Varshaphal reading for a given year
Jyotish practitioners — building year-ahead predictive reports using the Tajika system without manual solar return calculations
Astrology platforms and apps — powering annual forecast features that display the Varshaphal chart alongside the natal chart
Year-specific transit and dasha analysis — combining Varshaphal planetary positions with other predictive techniques for layered annual forecasting
Comparative chart tools — enabling side-by-side analysis of the natal chart and the current year's Varshaphal chart
Accepts both birth location and current location separately — the birth data anchors the natal chart, while the current latitude, longitude, and timezone determine where the solar return chart is cast, reflecting the individual's actual place of residence in the target year
Accepts a target Varshaphal year (varshaphalYear) to compute the solar return for any past, present, or future year, enabling historical review as well as forward planning
Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring the sidereal calculations align with the practitioner's preferred tradition
Returns full planetary detail — not just sign placements but degree-level precision, retrograde status, nakshatra, and dignity — providing everything needed for a complete Varshaphal interpretation
Designed for localization — the Accept-Language header controls the language of descriptive content in the response
Serves as the planetary data layer for Varshaphal analysis, intended to be used alongside other Varshaphal endpoints (houses, yogas, Muntha, etc.) for a complete 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.
The Varshaphal Planets 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 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 consumes 1 API credit. The endpoint delivers high performance with an average response time of ~117ms.
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.