SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Year Chart 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/chart/extended
en
hi
ma
Methodology and astrological context for 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.
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.
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
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
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
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 Year Chart Extended.
The Varshaphal Year Chart 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 Year Chart 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 Year Chart Extended consumes 1 API credit. The endpoint delivers high performance with an average response time of ~69ms.
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.