SEARCH ASTRO INSIGHT API DOCS
The Ascendant Report API generates a detailed analysis of the ascendant (Lagna), including personality characteristics, strengths, challenges, and life direction according to Vedic astrology.
https://json.astroinsightapi.com/api/v1/life-report/ascendant
en
hi
Methodology and astrological context for Ascendant Report.
The Ascendant Report API generates a comprehensive life report based on the native's Ascendant (Lagna) — the zodiac sign rising on the eastern horizon at the exact moment and location of birth. In Vedic astrology, the Ascendant is the single most important point in the birth chart. It defines the first house, establishes the entire house framework of the chart, and acts as the primary lens through which the native experiences life. The Ascendant sign governs physical appearance, core personality, natural disposition, health tendencies, and the overall direction of the native's life journey.
This API accepts a native's birth date, time, and geographic coordinates, precisely calculates the Ascendant sign using the specified Ayanamsha, and returns a rich, interpretive report that explains the deep implications of that Lagna across all major life dimensions.
What data it returns
Main use cases
Key functionality
X-Ayanamsha header, ensuring compatibility with different Jyotish calculation traditionsAccept-Language header, making the API suitable for regional and multilingual astrology platformsPayload 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
|
| 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 Ascendant Report.
The Ascendant Report API provides authentic Life Report 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 Ascendant Report 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 Ascendant Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~50ms.
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. 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.