Varshaphal Year Chart Image API

Varshaphal Year Chart Image

Generates and returns a Varshaphal (Solar Return) chart as a direct image file. This endpoint computes the solar return chart for the target year and renders it as a chart diagram image, returning the raw image binary rather than a JSON wrapper — making it ideal for use cases where the image needs to be streamed, downloaded, or embedded directly without additional parsing.

What This API Does

This endpoint accepts the individual's birth details, their current geographic location for the target year, and the desired Varshaphal year, then computes the solar return chart and renders it as a chart image. 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 endpoint returns the chart as an image file, with full control over the visual style, color scheme, dimensions, and symbol preferences — enabling seamless integration into any interface or document pipeline that consumes image assets directly.

Data Returned

The response is a rendered chart image file containing:

• Varshaphal solar return chart diagram — a complete visual chart with all planets placed in their solar return houses and signs

• Ascendant and house structure — the Varshaphal Lagna and house divisions rendered within the chart layout

• Planet and sign labels — zodiac signs and planet symbols or abbreviations rendered in the specified style and language

• Full visual styling — chart rendered according to the specified style (North, South, or East Indian), background color, line colors, planet and sign colors, chart size, line widths, and font sizes

Main Use Cases

• Direct image embedding — serving the chart image directly to a frontend tag, mobile image view, or canvas element without any intermediate JSON parsing

• File download and export — enabling users to download their Varshaphal chart as an image file from an astrology app or web portal

• PDF and document generation — inserting the chart image directly into report generation pipelines (e.g., PDF libraries, document templates) that consume raw image streams

• Caching and CDN delivery — storing the rendered chart image on a CDN or object storage for fast repeated delivery without re-rendering

• Print and sharing workflows — generating a high-quality chart image for printing, sharing via messaging apps, or attaching to emails

Key Functionality

• Returns the chart as a raw image file rather than a JSON response, making it directly consumable by image rendering contexts without additional parsing or decoding steps

• Accepts both birth location and current location separately — birth data anchors the natal chart calculation, 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) to match regional practitioner and user preferences

• 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, and planet font size — enabling pixel-level control over the chart's appearance

• Supports planet symbol styles (planetSymbol, signSymbol) to switch between traditional abbreviations and symbolic glyphs

• Designed for localization — the Accept-Language header controls the language used for any text labels within the rendered chart

• Complements the Varshaphal Year Chart and Varshaphal Year Chart Extended endpoints: use those when a JSON response with embedded chart data is needed, and this endpoint when a raw image file output is required