Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Lal Kitab Birth Chart Image

The Lal Kitab Birth Chart Image API generates a graphical Lal Kitab birth chart suitable for astrology applications, websites, and downloadable reports.

https://json.astroinsightapi.com/api/v1/chart/lalkitab/birth-chart/image
Credit Cost
1 Credit
Avg Latency
~62ms
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 Lal Kitab Birth Chart Image.

The Lal Kitab Birth Chart Image API generates a fully rendered, visually customizable birth chart (Kundali) image based on the Lal Kitab astrological system. Rather than returning raw chart data, this endpoint produces a ready-to-display chart graphic, making it ideal for applications that need to present a Lal Kitab natal chart directly to end users without any client-side rendering logic.

What This API Returns

Given a person's birth date, time, geographic coordinates, and a set of visual configuration options, the API computes the Lal Kitab birth chart and returns a rendered chart image. The output includes:

  • A rendered birth chart image — a complete Lal Kitab Kundali diagram with planetary placements across the 12 houses, drawn according to the specified chart style
  • Chart style variants — support for North Indian, South Indian, and East Indian chart layouts, each with their own traditional visual structure
  • Fully customized visuals — the image reflects all caller-specified styling: background color, line colors, sign and planet colors, font sizes, line widths, and chart dimensions
  • Symbol or text rendering — planets and signs can be rendered as traditional symbols or as text labels/numbers, depending on the caller's preference
  • Ayanamsha-corrected planetary positions — all placements in the image are computed using the specified Ayanamsha for astronomical accuracy

Main Use Cases

  • Astrology apps and portals — embedding a ready-made Kundali image directly into a user's birth chart page or PDF report without needing a front-end chart rendering library
  • Horoscope report generation — generating printable or shareable birth chart images as part of automated PDF or email horoscope reports
  • White-label astrology products — using the extensive styling parameters to match the chart's visual appearance to a product's brand identity (colors, fonts, sizes)
  • Multi-regional astrology platforms — serving users who prefer different regional chart styles (North, South, or East Indian) from a single API
  • Mobile and web applications — offloading chart rendering to the server side to reduce client complexity and ensure consistent visual output across devices

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 Lal Kitab Birth Chart Image.

What is the Lal Kitab Birth Chart Image API and what data does it provide?

The Lal Kitab Birth Chart Image API provides authentic Lal Kitab 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 Lal Kitab Birth Chart Image?

The Lal Kitab Birth 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 Lal Kitab Birth Chart Image endpoint consume?

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

How do I authenticate with the Lal Kitab Birth 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 Lal Kitab Birth 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 Lal Kitab Birth 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/lalkitab/birth-chart/image
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories