Overview

The Vimsottari Dasa is regarded as the most widely used planetary period system in contemporary Vedic astrology. According to the ancient text Brihat Parasara Hora Shastra, Sage Parasara identified this dasa system as particularly appropriate for the Kali Yuga. The term Vimsottari translates to 120, which signifies the total length of the complete dasa cycle—120 years. Each planet governs a specific number of years within this cycle, and the combined duration of all planetary periods equals 120 years. In Kali Yuga, it is believed that the ideal human lifespan, or paramaayush, is 120 years. This aligns perfectly with the structure of the Vimsottari Dasa, making it especially relevant and applicable in this age.

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": 1994,
    "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": "{\"1\": {\"Lord\": \"Jupiter\", \"start_time\": \"1975-06-29 07:14:45.880134\", \"end_time\": \"1991-06-29 09:41:23.473734\"}, \"2\": {\"Lord\": \"Saturn\", \"start_time\": \"1991-06-29 09:41:23.473734\", \"end_time\": \"2010-06-29 06:35:30.616134\"}, \"3\": {\"Lord\": \"Mercury\", \"start_time\": \"2010-06-29 06:35:30.616134\", \"end_time\": \"2027-06-29 15:11:18.059334\"}, \"4\": {\"Lord\": \"Ketu\", \"start_time\": \"2027-06-29 15:11:18.059334\", \"end_time\": \"2034-06-29 10:15:27.006534\"}, \"5\": {\"Lord\": \"Venus\", \"start_time\": \"2034-06-29 10:15:27.006534\", \"end_time\": \"2054-06-29 13:18:43.998534\"}, \"6\": {\"Lord\": \"Sun\", \"start_time\": \"2054-06-29 13:18:43.998534\", \"end_time\": \"2060-06-29 02:13:43.096134\"}, \"7\": {\"Lord\": \"Moon\", \"start_time\": \"2060-06-29 02:13:43.096134\", \"end_time\": \"2070-06-29 15:45:21.592134\"}, \"8\": {\"Lord\": \"Mars\", \"start_time\": \"2070-06-29 15:45:21.592134\", \"end_time\": \"2077-06-29 10:49:30.539334\"}, \"9\": {\"Lord\": \"Rahu\", \"start_time\": \"2077-06-29 10:49:30.539334\", \"end_time\": \"2095-06-30 01:34:27.832134\"}}"
}

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',
  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": 1988,
  "month": 10,
  "date": 22,
  "hours": 22,
  "minutes": 5,
  "seconds": 0,
  "latitude": 27.395527,
  "longitude": 80.131325,
  "timezone": 5.5,
  "config": {
    "observation_point": "geocentric",
    "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"

payload = json.dumps({
  "year": 1988,
  "month": 10,
  "date": 22,
  "hours": 22,
  "minutes": 5,
  "seconds": 0,
  "latitude": 27.395527,
  "longitude": 80.131325,
  "timezone": 5.5,
  "config": {
    "observation_point": "geocentric",
    "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',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1988,
    "month": 10,
    "date": 22,
    "hours": 22,
    "minutes": 5,
    "seconds": 0,
    "latitude": 27.395527,
    "longitude": 80.131325,
    "timezone": 5.5,
    "config": {
      "observation_point": "geocentric",
      "ayanamsha": "lahiri"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Vimsottari Maha Dasas

Overview

Request Parameters

Request Example

Response Examples

Code Examples