SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Year Chart Image 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/image/extended
en
hi
ma
Methodology and astrological context for Varshaphal Year Chart Image Extended.
Generates and returns an extended Varshaphal (Solar Return) dual-chart as a direct image file, rendering both the natal birth chart and the Varshaphal solar return chart together in a single combined diagram. This endpoint is the image-file counterpart to the Varshaphal Year Chart Extended endpoint — returning the same dual-chart layout as a raw image binary rather than a JSON response, making it ideal for direct embedding, download, and document pipeline use cases.
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 single combined chart image file. 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 dual-chart layout — showing both the natal and annual charts side by side — is the standard presentation format in Varshaphal consultations, and this endpoint delivers it as a ready-to-use image asset with full visual customization support.
The response is a rendered dual-chart image file containing:
Combined natal and Varshaphal chart diagram — both charts rendered together in a single image, with each chart section displaying its respective planetary placements, ascendant, and house structure
Planetary placements for both charts — all planets shown in their natal and solar return positions within their respective chart sections
Ascendant and house cusps for both charts — the natal Lagna and Varshaphal Lagna rendered within their respective sections of the combined layout
Planet and sign labels — zodiac signs and planet symbols or abbreviations rendered in the specified style and language across both chart sections
Full visual styling — the combined image rendered according to the specified chart style, background color, line colors, planet and sign colors, chart size, line widths, and font sizes, applied consistently across both charts
Direct image embedding — serving the combined natal and Varshaphal chart image directly to a frontend <img class='preserveHtml' class='preserveHtml' class='preserveHtml'> tag, mobile image view, or canvas element without JSON parsing
File download and export — enabling users to download their combined annual chart as a single image file from an astrology app or web portal
PDF and document generation — inserting the dual-chart image directly into report generation pipelines (e.g., PDF libraries, document templates) that consume raw image streams, delivering a practitioner-standard layout in one asset
Caching and CDN delivery — storing the rendered dual-chart image on a CDN or object storage for fast repeated delivery without re-rendering
Print and sharing workflows — generating a single high-quality image containing both charts for printing, sharing via messaging apps, or attaching to client emails
Comparative annual analysis — providing users with a single visual that shows how their annual planetary positions relate to their natal chart, without requiring client-side chart composition
Returns the combined natal and Varshaphal dual-chart as a raw image file, making it directly consumable by image rendering contexts and eliminating the need for client-side chart composition or JSON parsing
Renders both the natal birth chart and the Varshaphal solar return chart in a single image — the standard dual-chart format used in 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 for the target year
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 formats (chartStyle) applied consistently across both chart sections in the combined layout
Accepts a comprehensive set of visual customization parameters — background color (bgColor), inner and outer line colors and widths, sign color, planet color, chart size in pixels, sign font size, planet font size, and symbol styles — enabling pixel-level control over the appearance of the combined image
Designed for localization — the Accept-Language header controls the language used for any text labels within the rendered chart
Complements the full Varshaphal chart endpoint family: use the Varshaphal Year Chart Image endpoint when only the solar return chart image is needed, and this endpoint when a raw image file of the 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
|
|
chartStyle
Optional
|
string |
Chart display style. Supported values: north, south, east. Default is north.
Example:
north
|
|
bgColor
Optional
|
string |
Background color of the chart in HEX format. Default is #FFFEC9.
Example:
#FFFEC9
|
|
innerLineColor
Optional
|
string |
Inner line color of the chart in HEX format. Default is #FFC000.
Example:
#FFC000
|
|
outerLineColor
Optional
|
string |
Outer line color of the chart in HEX format. Default is #FFC000.
Example:
#FFC000
|
|
signColor
Optional
|
string |
Color of zodiac signs in HEX format. Default is #FF0000.
Example:
#FF0000
|
|
planetColor
Optional
|
string |
Color of planet names/symbols in HEX format. Default is #0000FF.
Example:
#0000FF
|
|
chartSize
Optional
|
integer |
Size of the chart in pixels. Default is 350.
Example:
350
|
|
innerLineWidth
Optional
|
integer |
Width of inner chart lines. Default is 2.
Example:
2
|
|
outerLineWidth
Optional
|
integer |
Width of outer chart lines. Default is 5.
Example:
5
|
|
signFontSize
Optional
|
integer |
Font size of zodiac signs. Default is 15.
Example:
15
|
|
planetFontSize
Optional
|
integer |
Font size of planet names/symbols. Default is 15.
Example:
15
|
|
signSymbol
Optional
|
string |
Display zodiac sign symbol or number. Y = show symbol, N = show number. Default is N.
Example:
N
|
|
planetSymbol
Optional
|
string |
Display planet symbol or name. Y = show symbol, N = show name. Default is N.
Example:
N
|
| 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 Image Extended.
The Varshaphal Year Chart Image 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 Image 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 Image Extended consumes 1 API credit. The endpoint delivers high performance with an average response time of ~77ms.
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.