Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Panchang Chart Image

The Panchang Chart Image API provides Panchang 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/chart/panchang/image
Credit Cost
1 Credit
Avg Latency
~410ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

API Overview & Calculation Details

Methodology and astrological context for Panchang Chart Image.

Panchang Chart Image

The Panchang Chart Image API generates a rendered visual image of a Panchang chart for a given date, time, and geographic location. It combines the astronomical computation of a Vedic Panchang with a fully customisable chart rendering engine, returning a chart image that can be directly embedded in applications, websites, or printed materials.

What This API Does

This endpoint accepts a date, time, timezone, and geographic coordinates to compute the Panchang for that moment and location. In addition to the astrological inputs, it accepts a comprehensive set of chart styling parameters that control the visual appearance of the output. The API then renders the Panchang data into a chart image according to the specified style and returns it, eliminating the need for any client-side chart rendering logic.

What Data It Returns

The response delivers a rendered Panchang chart image. The image encodes the computed Vedic almanac data for the given date and location in a visual format, including:

  • Panchang Chart Layout — A structured chart diagram displaying the Panchang data in the chosen regional style (North Indian, South Indian, or East Indian)

  • Zodiac Signs — Displayed as symbols or numbers within the chart, depending on the signSymbol setting

  • Planetary Positions — Planets placed within the chart according to their computed sidereal positions, shown as symbols or names based on the planetSymbol setting

  • Rendered Visual Elements — Chart borders, inner and outer grid lines, sign labels, and planet labels, all styled according to the provided color and size configuration

Main Use Cases

  • Astrology & Jyotish Applications — Embedding ready-made Panchang chart images directly into Vedic astrology apps without building a custom chart renderer

  • Hindu Calendar & Almanac Platforms — Displaying a visual daily Panchang chart alongside textual almanac data for a richer user experience

  • Kundali & Horoscope Report Generation — Including a Panchang chart image in PDF or web-based horoscope reports for clients

  • Religious & Spiritual Portals — Showing a visually styled Panchang chart on daily Panchang pages, festival pages, or puja scheduling tools

  • Print & Publishing Tools — Generating chart images for inclusion in printed almanacs, religious booklets, or astrological publications

  • White-Label Astrology Products — Producing fully branded chart images by customising colors, sizes, and styles to match a product's visual identity

Key Functionality

  • Multiple Chart Styles — Supports North Indian, South Indian, and East Indian chart layouts via the chartStyle parameter, catering to regional Vedic astrology traditions

  • Full Visual Customisation — Exposes granular control over every visual aspect of the chart: background color (bgColor), inner and outer line colors and widths (innerLineColor, outerLineColor, innerLineWidth, outerLineWidth), sign color (signColor), planet color (planetColor), chart size (chartSize), and font sizes for signs and planets (signFontSize, planetFontSize)

  • Symbol or Text Display — Signs can be rendered as traditional astrological symbols or as numbers (signSymbol), and planets can be shown as symbols or their abbreviated names (planetSymbol), giving flexibility for different audiences

  • Server-Side Rendering — The entire chart is rendered on the server, so clients receive a finished image with no dependency on client-side graphics libraries or rendering engines

  • Ayanamsha Support — Planetary positions within the chart are computed using the Ayanamsha system specified via the X-Ayanamsha header, ensuring compatibility with different schools of Vedic astrology

  • Location-Aware Computation — All Panchang data underlying the chart is calculated for the precise latitude, longitude, and timezone provided, guaranteeing geographic accuracy

  • Multi-Language Support — The Accept-Language header allows sign and planet labels within the chart to be rendered in the preferred language, supporting regional and international audiences

Request Parameters

Payload specifications for JSON request body.

application/json
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
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

Required & Optional Headers

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

Frequently Asked Questions

Comprehensive developer guidance for Panchang Chart Image.

What is the Panchang Chart Image API and what data does it provide?

The Panchang Chart Image API provides authentic Panchang 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.

What input parameters are required to call Panchang Chart Image?

The Panchang Chart Image 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.

How many credits does the Panchang Chart Image endpoint consume?

Each calculation request to Panchang Chart Image consumes 1 API credit. The endpoint delivers high performance with an average response time of ~410ms.

How do I authenticate with the Panchang Chart Image API?

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)).

Can I get Panchang Chart Image responses in regional Indian languages?

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.

Which Ayanamsha systems can be calculated with Panchang Chart Image?

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.

What response format and HTTP codes does this API return?

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.

POST chart/panchang/image
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories