Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Mahadasha Phal All Planets

The Mahadasha Phal All Planets 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/all
Credit Cost
1 Credit
Avg Latency
~80ms
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 Mahadasha Phal All Planets.

Mahadasha Phal All Planets

Returns the predicted results (Phal) of all nine Vimshottari Mahadashas for a given natal chart in a single response — the bulk variant of the Mahadasha Phal By Planet endpoint. Rather than retrieving the interpretive period assessment for one planet at a time, this endpoint generates natal-chart-aware Phal analyses for all nine Mahadasha lords (Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury, Ketu, and Venus) simultaneously, providing a complete lifetime Mahadasha interpretation map in one call.

What This API Does

This endpoint accepts an individual's birth details and computes the Mahadasha Phal assessment for every planet in the Vimshottari system against the individual's natal chart. For each of the nine Mahadasha lords, it evaluates the dasha lord's sign placement, house position, dignity, nakshatra, aspects received, conjunctions, house rulership, and planetary relationships in the natal chart, then synthesizes these factors into a structured interpretive output covering the predicted themes, life domain influences, and overall quality of that planet's Mahadasha. The result is a comprehensive, chart-specific interpretation of the individual's entire Vimshottari Mahadasha sequence — past, present, and future — delivered in a single response.

Data Returned

The response provides a complete Mahadasha Phal assessment for all nine planets:

  • Per-planet Phal assessments — for each of the nine Vimshottari Mahadasha lords, a full interpretive assessment identical in depth and structure to what the Mahadasha Phal By Planet endpoint returns for a single planet, covering overall period quality, dasha lord natal analysis, house rulership analysis, life domain predictions, planetary relationship influences, and period themes

  • Overall period quality per Mahadasha — a summary evaluation of each Mahadasha's general tone and favorability for the individual based on the respective dasha lord's natal chart condition

  • Dasha lord natal analysis per planet — sign, house, dignity, nakshatra, retrograde status, combustion, strength, and key planetary relationships for each of the nine dasha lords in the natal chart

  • Life domain predictions per Mahadasha — specific assessments of the areas of life (career, finances, relationships, health, spirituality, travel, family, education) most likely to be influenced during each planet's Mahadasha

  • Period themes and Karakatvas per planet — the natural significations of each dasha lord and how those themes are likely to manifest as experiences during its Mahadasha, personalized to the individual's chart

  • Comparative quality indicators — relative assessments that allow the nine Mahadashas to be compared against each other in terms of overall favorability, enabling identification of the most and least auspicious major periods in the individual's life

Main Use Cases

  • Complete lifetime Mahadasha report generation — retrieving the full interpretive Phal assessment for all nine Mahadashas in a single call to power comprehensive natal reports that cover the individual's entire Vimshottari period sequence from birth to the end of the 120-year cycle

  • Jyotish practitioners — obtaining a complete chart-specific Mahadasha interpretation map at the start of a consultation, providing an immediate overview of the quality and themes of every major period in the individual's life without making nine separate calls

  • Astrology platforms and apps — powering lifetime dasha interpretation features that display personalized Phal assessments for all nine Mahadashas in a single view, such as a life timeline with period-by-period predictions

  • Automated natal report pipelines — serving as the single data source for the Mahadasha interpretation section of automated Jyotish reports, eliminating the need for nine sequential Mahadasha Phal By Planet calls

  • Comparative Mahadasha analysis — enabling users and practitioners to compare the predicted quality of all nine Mahadashas side by side, identifying the most favorable and most challenging major periods across the individual's entire life

  • Dasha preparation and life planning — providing clients with a complete picture of all their Mahadasha periods and their predicted themes, enabling long-range life planning and advance preparation for upcoming major period transitions

  • Research and pattern analysis — analyzing the full set of nine Mahadasha Phal assessments for a natal chart to identify patterns in how the chart's planetary configuration shapes the quality of different major periods across the lifetime

Key Functionality

  • Returns Phal assessments for all nine Vimshottari Mahadasha lords in a single response — Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury, Ketu, and Venus — eliminating the need for nine sequential Mahadasha Phal By Planet calls and providing the complete lifetime Mahadasha interpretation map in one request

  • Each per-planet assessment is natal-chart-specific rather than generic, reflecting the dasha lord's actual house placement, dignity, rulership, and planetary relationships in the individual's horoscope — the same depth of personalization as the single-planet endpoint, applied to all nine simultaneously

  • Synthesizes multiple chart factors for each dasha lord into a unified period assessment — sign, house, dignity, nakshatra, aspects, conjunctions, house rulership, and natural significations are all evaluated together for every planet

  • Includes comparative quality indicators across all nine Mahadashas, enabling relative ranking of period favorability that is not available when calling the single-planet endpoint nine times independently

  • Covers multiple life domains for each of the nine Mahadashas in a single response, assessing each dasha lord's likely influence across career, finances, relationships, health, spirituality, and other areas

  • Accepts only birth details (date, time, and place of birth) with no path parameters or current location required, keeping the request payload minimal despite the breadth of the response

  • 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 across all nine Phal assessments in the response

  • Serves as the bulk complement to the Mahadasha Phal By Planet endpoint — use the single-planet endpoint when only one Mahadasha's Phal is needed, and this endpoint when the complete nine-Mahadasha interpretation set is required in one call

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

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 Mahadasha Phal All Planets.

What is the Mahadasha Phal All Planets API and what data does it provide?

The Mahadasha Phal All Planets 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.

What input parameters are required to call Mahadasha Phal All Planets?

The Mahadasha Phal All Planets 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 Mahadasha Phal All Planets endpoint consume?

Each calculation request to Mahadasha Phal All Planets consumes 1 API credit. The endpoint delivers high performance with an average response time of ~80ms.

How do I authenticate with the Mahadasha Phal All Planets 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 Mahadasha Phal All Planets 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 Mahadasha Phal All Planets?

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 dasha/vimshottari/mahadasha-phal/all
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories