POST
Vimsottari Maha Dasas and Antar Dasas
Calculate Vimsottari Maha Dasha and Antar Dasha periods from birth details using the traditional 120-year Vedic astrology system. Retrieve major and sub-period timelines with planetary lords, start dates, and end dates for detailed horoscope analysis and predictive astrology applications.
/vimsottari/maha-dasas-and-antar-dasas
Method
POST
Format
JSON
Auth
API Key
Credits
1
Overview
The Vimsottari Maha Dasa and Antar Dasas API calculates the major planetary periods (Maha Dasa) and their corresponding sub-periods (Antar Dasa) according to the traditional 120-year Vimsottari Dasha system used in Vedic astrology. It helps developers understand the sequence of planetary periods associated with a native's birth chart.
The API provides the planetary lord and start and end times for each Maha Dasa, along with the Antar Dasa periods within the major planetary periods. This detailed timeline helps developers identify planetary period transitions and present both major and sub-periods in a structured format for horoscope analysis and predictive astrology.
This endpoint is useful for building Vedic astrology applications, horoscope analysis tools, Dasha timeline calculators, and personalized astrology reports. To calculate the periods, provide the birth year, month, date, time, latitude, longitude, and timezone. You can also configure the observation point as geocentric or topocentric and select a supported Ayanamsha setting, such as Lahiri or Sayana. The API returns the calculated periods in JSON format for easy integration into web applications, mobile apps, and astrology platforms.
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year
|
integer | Yes | Year number, eg: 2023 | 2023 |
month
|
integer | Yes | Month number,with no leading zero | 7 |
date
|
integer | Yes | Day number,with no leading zero | 5 |
hours
|
integer | Yes | Hours number,with no leading zero | 1 |
minutes
|
integer | Yes | Minutes number,with no leading zero | 1 |
seconds
|
integer | Yes | Seconds number, with no leading zero | 0 |
latitude
|
float | Yes | Latitude number, in the range from -90 to 90 | 12.86 |
longitude
|
float | Yes | Longitude number, in the range from -180 to 180 | 123.5 |
timezone
|
float | Yes | Timezone of birth location, eg: 5.5 | 5.5 |
config
|
object | No | Contains optional configuration values | |
ayanamsha
|
string | No | Either "tropical" or "sayana" or "lahiri" | Either "tropical" or "sayana" or "lahiri" |
observation_point
|
string | No | Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place | Either "topocentric" or "geocentric" |
Request Example
{
"year": 1999,
"month": 4,
"date": 30,
"hours": 12,
"minutes": 45,
"seconds": 0,
"latitude": 21.1904,
"longitude": 81.28491,
"timezone": 5.5,
"config": {
"observation_point": "topocentric", /* geocentric / topocentric */
"ayanamsha": "lahiri" /* lahiri / sayana */
}
}Response Examples
Example responses returned by this API.
Response
{
"statusCode": 200,
"output": "{\"Mercury\": {\"Mercury\": {\"start_time\": \"1976-11-15 01:35:43\", \"end_time\": \"1979-04-13 17:24:36\"}, \"Ketu\": {\"start_time\": \"1979-04-13 17:24:36\", \"end_time\": \"1980-04-09 22:30:41\"}, \"Venus\": {\"start_time\": \"1980-04-09 22:30:41\", \"end_time\": \"1983-02-08 19:56:38\"}, \"Sun\": {\"start_time\": \"1983-02-08 19:56:38\", \"end_time\": \"1983-12-16 07:10:26\"}, \"Moon\": {\"start_time\": \"1983-12-16 07:10:26\", \"end_time\": \"1985-05-16 17:53:24\"}, \"Mars\": {\"start_time\": \"1985-05-16 17:53:24\", \"end_time\": \"1986-05-13 22:59:27\"}, \"Rahu\": {\"start_time\": \"1986-05-13 22:59:27\", \"end_time\": \"1988-11-30 08:40:50\"}, \"Jupiter\": {\"start_time\": \"1988-11-30 08:40:50\", \"end_time\": \"1991-03-08 06:37:36\"}, \"Saturn\": {\"start_time\": \"1991-03-08 06:37:36\", \"end_time\": \"1993-11-15 10:11:16\"}}, \"Ketu\": {\"Ketu\": {\"start_time\": \"1993-11-15 10:11:16\", \"end_time\": \"1994-04-13 13:41:59\"}, \"Venus\": {\"start_time\": \"1994-04-13 13:41:59\", \"end_time\": \"1995-06-13 16:52:41\"}, \"Sun\": {\"start_time\": \"1995-06-13 16:52:41\", \"end_time\": \"1995-10-19 13:01:53\"}, \"Moon\": {\"start_time\": \"1995-10-19 13:01:53\", \"end_time\": \"1996-05-19 14:37:14\"}, \"Mars\": {\"start_time\": \"1996-05-19 14:37:14\", \"end_time\": \"1996-10-15 18:07:57\"}, \"Rahu\": {\"start_time\": \"1996-10-15 18:07:57\", \"end_time\": \"1997-11-03 06:35:35\"}, \"Jupiter\": {\"start_time\": \"1997-11-03 06:35:35\", \"end_time\": \"1998-10-10 04:18:23\"}, \"Saturn\": {\"start_time\": \"1998-10-10 04:18:23\", \"end_time\": \"1999-11-19 00:07:32\"}, \"Mercury\": {\"start_time\": \"1999-11-19 00:07:32\", \"end_time\": \"2000-11-15 05:13:37\"}}, \"Venus\": {\"Venus\": {\"start_time\": \"2000-11-15 05:13:37\", \"end_time\": \"2004-03-16 17:44:09\"}, \"Sun\": {\"start_time\": \"2004-03-16 17:44:09\", \"end_time\": \"2005-03-16 23:53:19\"}, \"Moon\": {\"start_time\": \"2005-03-16 23:53:19\", \"end_time\": \"2006-11-15 18:08:33\"}, \"Mars\": {\"start_time\": \"2006-11-15 18:08:33\", \"end_time\": \"2008-01-15 21:19:15\"}, \"Rahu\": {\"start_time\": \"2008-01-15 21:19:15\", \"end_time\": \"2011-01-15 15:46:44\"}, \"Jupiter\": {\"start_time\": \"2011-01-15 15:46:44\", \"end_time\": \"2013-09-15 16:11:10\"}, \"Saturn\": {\"start_time\": \"2013-09-15 16:11:10\", \"end_time\": \"2016-11-15 07:40:11\"}, \"Mercury\": {\"start_time\": \"2016-11-15 07:40:11\", \"end_time\": \"2019-09-16 05:06:09\"}, \"Ketu\": {\"start_time\": \"2019-09-16 05:06:09\", \"end_time\": \"2020-11-15 08:16:51\"}}, \"Sun\": {\"Sun\": {\"start_time\": \"2020-11-15 08:16:51\", \"end_time\": \"2021-03-04 22:07:36\"}, \"Moon\": {\"start_time\": \"2021-03-04 22:07:36\", \"end_time\": \"2021-09-03 13:12:11\"}, \"Mars\": {\"start_time\": \"2021-09-03 13:12:11\", \"end_time\": \"2022-01-09 09:21:23\"}, \"Rahu\": {\"start_time\": \"2022-01-09 09:21:23\", \"end_time\": \"2022-12-04 02:53:38\"}, \"Jupiter\": {\"start_time\": \"2022-12-04 02:53:38\", \"end_time\": \"2023-09-22 07:48:58\"}, \"Saturn\": {\"start_time\": \"2023-09-22 07:48:58\", \"end_time\": \"2024-09-03 07:39:40\"}, \"Mercury\": {\"start_time\": \"2024-09-03 07:39:40\", \"end_time\": \"2025-07-10 18:53:28\"}, \"Ketu\": {\"start_time\": \"2025-07-10 18:53:28\", \"end_time\": \"2025-11-15 15:02:40\"}, \"Venus\": {\"start_time\": \"2025-11-15 15:02:40\", \"end_time\": \"2026-11-15 21:11:50\"}}, \"Moon\": {\"Moon\": {\"start_time\": \"2026-11-15 21:11:50\", \"end_time\": \"2027-09-16 06:19:18\"}, \"Mars\": {\"start_time\": \"2027-09-16 06:19:18\", \"end_time\": \"2028-04-16 07:52:53\"}, \"Rahu\": {\"start_time\": \"2028-04-16 07:52:53\", \"end_time\": \"2029-10-16 05:06:38\"}, \"Jupiter\": {\"start_time\": \"2029-10-16 05:06:38\", \"end_time\": \"2031-02-15 05:18:40\"}, \"Saturn\": {\"start_time\": \"2031-02-15 05:18:40\", \"end_time\": \"2032-09-15 13:01:26\"}, \"Mercury\": {\"start_time\": \"2032-09-15 13:01:26\", \"end_time\": \"2034-02-14 23:44:04\"}, \"Ketu\": {\"start_time\": \"2034-02-14 23:44:04\", \"end_time\": \"2034-09-16 01:19:14\"}, \"Venus\": {\"start_time\": \"2034-09-16 01:19:14\", \"end_time\": \"2036-05-16 19:31:00\"}, \"Sun\": {\"start_time\": \"2036-05-16 19:31:00\", \"end_time\": \"2036-11-15 10:35:35\"}}, \"Mars\": {\"Mars\": {\"start_time\": \"2036-11-15 10:35:35\", \"end_time\": \"2037-04-13 14:06:09\"}, \"Rahu\": {\"start_time\": \"2037-04-13 14:06:09\", \"end_time\": \"2038-05-02 02:33:46\"}, \"Jupiter\": {\"start_time\": \"2038-05-02 02:33:46\", \"end_time\": \"2039-04-08 00:18:18\"}, \"Saturn\": {\"start_time\": \"2039-04-08 00:18:18\", \"end_time\": \"2040-05-16 20:07:28\"}, \"Mercury\": {\"start_time\": \"2040-05-16 20:07:28\", \"end_time\": \"2041-05-14 01:13:33\"}, \"Ketu\": {\"start_time\": \"2041-05-14 01:13:33\", \"end_time\": \"2041-10-10 04:44:17\"}, \"Venus\": {\"start_time\": \"2041-10-10 04:44:17\", \"end_time\": \"2042-12-10 07:54:38\"}, \"Sun\": {\"start_time\": \"2042-12-10 07:54:38\", \"end_time\": \"2043-04-17 04:03:50\"}, \"Moon\": {\"start_time\": \"2043-04-17 04:03:50\", \"end_time\": \"2043-11-16 05:39:10\"}}, \"Rahu\": {\"Rahu\": {\"start_time\": \"2043-11-16 05:39:10\", \"end_time\": \"2046-07-29 10:15:54\"}, \"Jupiter\": {\"start_time\": \"2046-07-29 10:15:54\", \"end_time\": \"2048-12-22 01:01:54\"}, \"Saturn\": {\"start_time\": \"2048-12-22 01:01:54\", \"end_time\": \"2051-10-29 00:34:01\"}, \"Mercury\": {\"start_time\": \"2051-10-29 00:34:01\", \"end_time\": \"2054-05-17 10:15:23\"}, \"Ketu\": {\"start_time\": \"2054-05-17 10:15:23\", \"end_time\": \"2055-06-04 22:43:01\"}, \"Venus\": {\"start_time\": \"2055-06-04 22:43:01\", \"end_time\": \"2058-06-04 17:10:30\"}, \"Sun\": {\"start_time\": \"2058-06-04 17:10:30\", \"end_time\": \"2059-04-29 10:42:45\"}, \"Moon\": {\"start_time\": \"2059-04-29 10:42:45\", \"end_time\": \"2060-10-28 07:56:30\"}, \"Mars\": {\"start_time\": \"2060-10-28 07:56:30\", \"end_time\": \"2061-11-15 20:24:07\"}}, \"Jupiter\": {\"Jupiter\": {\"start_time\": \"2061-11-15 20:24:07\", \"end_time\": \"2064-01-04 01:31:39\"}, \"Saturn\": {\"start_time\": \"2064-01-04 01:31:39\", \"end_time\": \"2066-07-17 09:05:07\"}, \"Mercury\": {\"start_time\": \"2066-07-17 09:05:07\", \"end_time\": \"2068-10-22 07:01:53\"}, \"Ketu\": {\"start_time\": \"2068-10-22 07:01:53\", \"end_time\": \"2069-09-28 04:46:26\"}, \"Venus\": {\"start_time\": \"2069-09-28 04:46:26\", \"end_time\": \"2072-05-29 05:10:50\"}, \"Sun\": {\"start_time\": \"2072-05-29 05:10:50\", \"end_time\": \"2073-03-17 10:06:10\"}, \"Moon\": {\"start_time\": \"2073-03-17 10:06:10\", \"end_time\": \"2074-07-17 10:18:23\"}, \"Mars\": {\"start_time\": \"2074-07-17 10:18:23\", \"end_time\": \"2075-06-23 08:02:46\"}, \"Rahu\": {\"start_time\": \"2075-06-23 08:02:46\", \"end_time\": \"2077-11-15 22:48:46\"}}, \"Saturn\": {\"Saturn\": {\"start_time\": \"2077-11-15 22:48:46\", \"end_time\": \"2080-11-18 18:17:34\"}, \"Mercury\": {\"start_time\": \"2080-11-18 18:17:34\", \"end_time\": \"2083-07-29 21:51:14\"}, \"Ketu\": {\"start_time\": \"2083-07-29 21:51:14\", \"end_time\": \"2084-09-06 17:40:23\"}, \"Venus\": {\"start_time\": \"2084-09-06 17:40:23\", \"end_time\": \"2087-11-07 09:09:24\"}, \"Sun\": {\"start_time\": \"2087-11-07 09:09:24\", \"end_time\": \"2088-10-19 09:00:06\"}, \"Moon\": {\"start_time\": \"2088-10-19 09:00:06\", \"end_time\": \"2090-05-20 16:44:37\"}, \"Mars\": {\"start_time\": \"2090-05-20 16:44:37\", \"end_time\": \"2091-06-29 12:33:45\"}, \"Rahu\": {\"start_time\": \"2091-06-29 12:33:45\", \"end_time\": \"2094-05-05 12:05:52\"}, \"Jupiter\": {\"start_time\": \"2094-05-05 12:05:52\", \"end_time\": \"2096-11-15 19:41:05\"}}}"
}Code Examples
Use the following examples to integrate this API into your application.
PHP Code
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://json.freeastrologyapi.com/vimsottari/maha-dasas-and-antar-dasas',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"year": 1987,
"month": 11,
"date": 4,
"hours": 5,
"minutes": 45,
"seconds": 0,
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "lahiri"
}
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'x-api-key: YOUR_API_KEY_HERE'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Python Code
import requests
import json
url = "https://json.freeastrologyapi.com/vimsottari/maha-dasas-and-antar-dasas"
payload = json.dumps({
"year": 1987,
"month": 11,
"date": 4,
"hours": 5,
"minutes": 45,
"seconds": 0,
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "lahiri"
}
})
headers = {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY_HERE'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Node JS Code
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://json.freeastrologyapi.com/vimsottari/maha-dasas-and-antar-dasas',
'headers': {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY_HERE'
},
body: JSON.stringify({
"year": 1987,
"month": 11,
"date": 4,
"hours": 5,
"minutes": 45,
"seconds": 0,
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "lahiri"
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});