Divine API
Copy page
Copy page as Markdown for LLMs
Vimshottari Dasha API
Navigate the cycles of life with our Vimshottari Dasha API, unraveling the dynamic planetary periods that shape individual destinies within the realm of Indian Astrology.
POST https://astroapi-3.divineapi.com/indian-api/v1/vimshottari-dasha
Returns Vimshottari Dasha data in the response.
This API calculates and returns planetary Dasha details from Maha Dasha (major period) down to Sookshma Dasha (sub-sub period) based on an individual's birth details.
Dasha Type Parameter
| Code | Description |
|---|---|
| maha-dasha | Returns only the Maha Dasha |
| antar-dasha | Returns Maha Dasha and Antar Dasha |
| pratyantar-dasha | Returns Maha Dasha, Antar Dasha, and Pratyantar Dasha |
| sookshma-dasha | Returns all levels — Maha Dasha, Antar Dasha, Pratyantar Dasha, and Sookshma Dasha |
Supported Language Codes
Support Article: Translating Indian/Vedic APIs into a Different Language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide:
Include the language code by passing the parameter lan in the request body.
Default language is English (en).
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Your API access token. Example: Bearer {token} |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | String | Yes | Your unique API key. |
| full_name | String | Yes | Full name of the individual. Example: Rahul Kumar |
| day | Integer | Yes | Date of birth. Example: 24 |
| month | Integer | Yes | Month of birth. Example: 05 |
| year | Integer | Yes | Year of birth. Example: 2023 |
| hour | Integer | Yes | Hour of birth (24-hour format). Example: 14 |
| min | Integer | Yes | Minute of birth. Example: 40 |
| sec | Integer | Yes | Second of birth. Example: 43 |
| gender | String | Yes | Gender. Example: male |
| place | String | Yes | Birthplace. Example: New Delhi |
| lat | Float | Yes | Latitude of birthplace. Example: 28.7041 |
| lon | Float | Yes | Longitude of birthplace. Example: 77.1025 |
| tzone | Float | Yes | Timezone offset from GMT. Example: 5.5 (Timezone List) |
| lan | String | No | Language code (default: en). |
| dasha_type | String | Yes | Dasha type — one of: maha-dasha, antar-dasha, pratyantar-dasha, or sookshma-dasha. |
Example Successful Response (200: OK)
{
"success": 1,
"data": {
"date": "2023-05-24",
"time": "14:40:43",
"maha_dasha": {
"Jupiter": {
"start_date": "2007-08-31",
"end_date": "2023-08-23",
"antar_dasha": {
"Jupiter": {
"start_time": "--",
"end_time": "--"
},
"Saturn": {
"start_time": "--",
"end_time": "--"
},
"Mercury": {
"start_time": "--",
"end_time": "--"
},
"Ketu": {
"start_time": "--",
"end_time": "--"
},
"Venus": {
"start_time": "--",
"end_time": "--"
},
"Sun": {
"start_time": "--",
"end_time": "--"
},
"Moon": {
"start_time": "--",
"end_time": "--"
},
"Mars": {
"start_time": "--",
"end_time": "--"
},
"Rahu": {
"start_time": "2021-04-07",
"end_time": "2023-08-23"
}
}
},
"Saturn": {
"start_date": "2023-08-23",
"end_date": "2042-08-23",
"antar_dasha": {
"Saturn": {
"start_time": "2023-08-23",
"end_time": "2026-08-26"
},
"Mercury": {
"start_time": "2026-08-26",
"end_time": "2029-05-05"
},
"Ketu": {
"start_time": "2029-05-05",
"end_time": "2030-06-14"
},
"Venus": {
"start_time": "2030-06-14",
"end_time": "2033-08-14"
},
"Sun": {
"start_time": "2033-08-14",
"end_time": "2034-07-26"
},
"Moon": {
"start_time": "2034-07-26",
"end_time": "2036-02-26"
},
"Mars": {
"start_time": "2036-02-26",
"end_time": "2037-04-04"
},
"Rahu": {
"start_time": "2037-04-04",
"end_time": "2040-02-10"
},
"Jupiter": {
"start_time": "2040-02-10",
"end_time": "2042-08-23"
}
}
},
"Mercury": {
"start_date": "2042-08-23",
"end_date": "2059-08-23",
"antar_dasha": {
"Mercury": {
"start_time": "2042-08-23",
"end_time": "2045-01-19"
},
"Ketu": {
"start_time": "2045-01-19",
"end_time": "2046-01-15"
},
"Venus": {
"start_time": "2046-01-15",
"end_time": "2048-11-15"
},
"Sun": {
"start_time": "2048-11-15",
"end_time": "2049-09-21"
},
"Moon": {
"start_time": "2049-09-21",
"end_time": "2051-02-21"
},
"Mars": {
"start_time": "2051-02-21",
"end_time": "2052-02-17"
},
"Rahu": {
"start_time": "2052-02-17",
"end_time": "2054-09-04"
},
"Jupiter": {
"start_time": "2054-09-04",
"end_time": "2056-12-10"
},
"Saturn": {
"start_time": "2056-12-10",
"end_time": "2059-08-23"
}
}
},
"Ketu": {
"start_date": "2059-08-23",
"end_date": "2066-08-23",
"antar_dasha": {
"Ketu": {
"start_time": "2059-08-23",
"end_time": "2060-01-19"
},
"Venus": {
"start_time": "2060-01-19",
"end_time": "2061-03-19"
},
"Sun": {
"start_time": "2061-03-19",
"end_time": "2061-07-25"
},
"Moon": {
"start_time": "2061-07-25",
"end_time": "2062-02-25"
},
"Mars": {
"start_time": "2062-02-25",
"end_time": "2062-07-22"
},
"Rahu": {
"start_time": "2062-07-22",
"end_time": "2063-08-09"
},
"Jupiter": {
"start_time": "2063-08-09",
"end_time": "2064-07-15"
},
"Saturn": {
"start_time": "2064-07-15",
"end_time": "2065-08-24"
},
"Mercury": {
"start_time": "2065-08-24",
"end_time": "2066-08-23"
}
}
},
"Venus": {
"start_date": "2066-08-23",
"end_date": "2086-08-23",
"antar_dasha": {
"Venus": {
"start_time": "2066-08-23",
"end_time": "2069-12-23"
},
"Sun": {
"start_time": "2069-12-23",
"end_time": "2070-12-23"
},
"Moon": {
"start_time": "2070-12-23",
"end_time": "2072-08-23"
},
"Mars": {
"start_time": "2072-08-23",
"end_time": "2073-10-23"
},
"Rahu": {
"start_time": "2073-10-23",
"end_time": "2076-10-23"
},
"Jupiter": {
"start_time": "2076-10-23",
"end_time": "2079-06-23"
},
"Saturn": {
"start_time": "2079-06-23",
"end_time": "2082-08-23"
},
"Mercury": {
"start_time": "2082-08-23",
"end_time": "2085-06-23"
},
"Ketu": {
"start_time": "2085-06-23",
"end_time": "2086-08-23"
}
}
},
"Sun": {
"start_date": "2086-08-23",
"end_date": "2092-08-23",
"antar_dasha": {
"Sun": {
"start_time": "2086-08-23",
"end_time": "2086-12-11"
},
"Moon": {
"start_time": "2086-12-11",
"end_time": "2087-06-11"
},
"Mars": {
"start_time": "2087-06-11",
"end_time": "2087-10-17"
},
"Rahu": {
"start_time": "2087-10-17",
"end_time": "2088-09-10"
},
"Jupiter": {
"start_time": "2088-09-10",
"end_time": "2089-06-28"
},
"Saturn": {
"start_time": "2089-06-28",
"end_time": "2090-06-09"
},
"Mercury": {
"start_time": "2090-06-09",
"end_time": "2091-04-15"
},
"Ketu": {
"start_time": "2091-04-15",
"end_time": "2091-08-21"
},
"Venus": {
"start_time": "2091-08-21",
"end_time": "2092-08-23"
}
}
},
"Moon": {
"start_date": "2092-08-23",
"end_date": "2102-08-23",
"antar_dasha": {
"Moon": {
"start_time": "2092-08-23",
"end_time": "2093-06-23"
},
"Mars": {
"start_time": "2093-06-23",
"end_time": "2094-01-23"
},
"Rahu": {
"start_time": "2094-01-23",
"end_time": "2095-07-23"
},
"Jupiter": {
"start_time": "2095-07-23",
"end_time": "2096-11-23"
},
"Saturn": {
"start_time": "2096-11-23",
"end_time": "2098-06-23"
},
"Mercury": {
"start_time": "2098-06-23",
"end_time": "2099-11-23"
},
"Ketu": {
"start_time": "2099-11-23",
"end_time": "2100-06-23"
},
"Venus": {
"start_time": "2100-06-23",
"end_time": "2102-02-23"
},
"Sun": {
"start_time": "2102-02-23",
"end_time": "2102-08-23"
}
}
},
"Mars": {
"start_date": "2102-08-23",
"end_date": "2109-08-23",
"antar_dasha": {
"Mars": {
"start_time": "2102-08-23",
"end_time": "2103-01-19"
},
"Rahu": {
"start_time": "2103-01-19",
"end_time": "2104-02-06"
},
"Jupiter": {
"start_time": "2104-02-06",
"end_time": "2105-01-12"
},
"Saturn": {
"start_time": "2105-01-12",
"end_time": "2106-02-21"
},
"Mercury": {
"start_time": "2106-02-21",
"end_time": "2107-02-17"
},
"Ketu": {
"start_time": "2107-02-17",
"end_time": "2107-07-14"
},
"Venus": {
"start_time": "2107-07-14",
"end_time": "2108-09-14"
},
"Sun": {
"start_time": "2108-09-14",
"end_time": "2109-01-20"
},
"Moon": {
"start_time": "2109-01-20",
"end_time": "2109-08-23"
}
}
},
"Rahu": {
"start_date": "2109-08-23",
"end_date": "2127-08-23",
"antar_dasha": {
"Rahu": {
"start_time": "2109-08-23",
"end_time": "2112-05-05"
},
"Jupiter": {
"start_time": "2112-05-05",
"end_time": "2114-09-29"
},
"Saturn": {
"start_time": "2114-09-29",
"end_time": "2117-08-04"
},
"Mercury": {
"start_time": "2117-08-04",
"end_time": "2120-02-22"
},
"Ketu": {
"start_time": "2120-02-22",
"end_time": "2121-03-12"
},
"Venus": {
"start_time": "2121-03-12",
"end_time": "2124-03-12"
},
"Sun": {
"start_time": "2124-03-12",
"end_time": "2125-02-05"
},
"Moon": {
"start_time": "2125-02-05",
"end_time": "2126-08-05"
},
"Mars": {
"start_time": "2126-08-05",
"end_time": "2127-08-23"
}
}
}
}
}
}
Example Integrations
Below are examples of how you might call this API using different programming languages and environments.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/vimshottari-dasha' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'dasha_type="antar-dasha"'
NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-3.divineapi.com/indian-api/v1/vimshottari-dasha',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'dasha_type': 'antar-dasha'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JavaScript (jQuery AJAX)
var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("dasha_type", "antar-dasha");
var settings = {
"url": "https://astroapi-3.divineapi.com/indian-api/v1/vimshottari-dasha",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Bearer {Your Auth Token}"
},
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
Python
import requests
url = "https://astroapi-3.divineapi.com/indian-api/v1/vimshottari-dasha"
payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'dasha_type': 'antar-dasha'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Reference
Support Article:
Step-by-Step Vimshottari Dasha API Postman Testing Integration