SEARCH ASTRO INSIGHT API DOCS
The Mahadasha Phal By Planet API provides vimshottari dasha related calculations and insights based on Vedic Astrology astrology data. This endpoint is designed for horoscope platforms, astrology applications, mobile apps, and developer integrations requiring accurate JSON responses and scalable REST API access.
https://json.astroinsightapi.com/api/v1/dasha/vimshottari/mahadasha-phal/:planetKey
en
hi
ma
Methodology and astrological context for Mahadasha Phal By Planet.
Returns the predicted results (Phal) of a specified planet's Vimshottari Mahadasha for a given natal chart — a natal chart-aware interpretive endpoint that generates a detailed assessment of the themes, experiences, and outcomes a person is likely to encounter during the major period governed by the specified planet. Unlike the structural dasha endpoints that return timelines and dates, this endpoint focuses on the qualitative and predictive dimension of Mahadasha analysis: what the period is likely to bring based on the dasha lord's natal chart condition, house rulership, placement, strength, and planetary relationships.
This endpoint accepts an individual's birth details and a planetKey path parameter specifying the Mahadasha lord, then analyzes the natal chart to generate a comprehensive Phal (results/fruits) assessment for that planet's Mahadasha. The analysis evaluates the dasha lord's sign placement, house position, dignity, nakshatra, aspects received, conjunctions, house rulership (both the house it rules and the house it occupies), and its relationships with other planets — all of which collectively determine the nature, quality, and likely themes of the Mahadasha period. The endpoint synthesizes these factors into a structured interpretive output covering the broad life domains most likely to be activated, the general tone of the period (favorable, challenging, or mixed), and the specific areas of life where the dasha lord's influence is most likely to manifest.
The response provides a comprehensive Mahadasha Phal assessment for the specified planet:
Overall period assessment — a summary evaluation of the Mahadasha's general quality and tone for the individual based on the dasha lord's natal chart condition, indicating whether the period is broadly favorable, challenging, or mixed
Dasha lord natal analysis — a detailed breakdown of the factors shaping the Mahadasha's results, including the lord's sign, house placement, dignity (exaltation, debilitation, own sign, friendly/enemy sign), nakshatra, retrograde status, combustion, and overall strength
House rulership analysis — an assessment of the houses the dasha lord rules in the natal chart (based on its sign lordship) and how those house significations are activated and expressed during the Mahadasha
Life domain predictions — specific assessments of the areas of life most likely to be influenced during the Mahadasha, such as career, finances, relationships, health, spirituality, travel, family, and education, based on the dasha lord's house placement and rulership
Planetary relationship influences — the effect of conjunctions, aspects, and sign/nakshatra dispositors on the dasha lord's ability to deliver its results, including whether benefic or malefic influences modify the period's outcomes
Period themes and significations — the natural significations (Karakatvas) of the dasha lord planet and how those themes are likely to manifest as experiences during the Mahadasha
Remedial context — where applicable, indicators of which life areas may benefit from attention or remedial measures during the Mahadasha based on the dasha lord's afflictions or weaknesses
Client Mahadasha consultations — generating a detailed, chart-specific interpretive assessment of an upcoming or current Mahadasha to explain to clients what themes and experiences the period is likely to bring across different areas of life
Jyotish practitioners — accessing a structured natal-chart-aware Phal analysis for any of the nine Mahadasha lords, saving the time required to manually synthesize the dasha lord's multiple chart factors into a coherent period interpretation
Astrology platforms and apps — powering Mahadasha interpretation features that display personalized period predictions for users based on their natal chart, going beyond bare dasha timelines to provide meaningful predictive content
Automated natal report generation — incorporating Mahadasha Phal assessments as a core section of automated Jyotish natal reports, providing the interpretive layer that transforms dasha timeline data into readable predictions
Dasha preparation and planning — helping clients understand the broad themes and likely challenges of an approaching Mahadasha so they can prepare, set intentions, or seek remedies in advance of the period beginning
Comparative Mahadasha analysis — running the endpoint for multiple planets to compare the predicted quality of different Mahadashas in a person's life, identifying which periods are likely to be most favorable or demanding based on the natal chart
Accepts a planetKey path parameter specifying the Mahadasha lord (sun, moon, mars, mercury, jupiter, venus, saturn, rahu, or ketu), enabling targeted Phal retrieval for any of the nine Vimshottari Mahadashas without requiring the caller to first navigate the dasha timeline
Generates a natal-chart-aware interpretation rather than a generic planetary description — the Phal assessment is specific to the individual's chart, reflecting the dasha lord's actual house placement, dignity, rulership, and planetary relationships in that particular horoscope
Synthesizes multiple chart factors into a unified period assessment — sign, house, dignity, nakshatra, aspects, conjunctions, house rulership, and natural significations are all evaluated together rather than in isolation, producing a holistic rather than piecemeal interpretation
Covers multiple life domains in a single response, assessing the dasha lord's likely influence across career, finances, relationships, health, spirituality, and other areas based on its specific natal chart position and rulership
Evaluates both natural and functional significations of the dasha lord — the planet's universal Karakatvas (natural significations) as well as the specific houses it rules and occupies in the individual's chart — providing a two-dimensional interpretive framework
Accepts only birth details (date, time, and place of birth) with no current location required, since Mahadasha Phal analysis is based entirely on the natal chart
Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, since planetary positions, house placements, and dignities vary by sidereal reference frame
Designed for localization — the Accept-Language header controls the language of all interpretive text, planet names, house names, dignity labels, and life domain descriptions in the response
Serves as the primary interpretive complement to the structural Vimshottari Dasha endpoints — while the Major, Antar, Pratyantar, Sookshma, and Pran endpoints provide the timing framework, this endpoint provides the predictive content that gives that framework meaning for the individual
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
|
| 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 Mahadasha Phal By Planet.
The Mahadasha Phal By Planet API provides authentic Vimshottari Dasha 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 Mahadasha Phal By Planet 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 Mahadasha Phal By Planet consumes 1 API credit. The endpoint delivers high performance with an average response time of ~59ms.
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.