Vimsottari Dasa information for a given Date

Overview

The Vimsottari Dasa Information API calculates the running planetary periods for a native according to the traditional Vimsottari Dasha system, a widely used predictive technique in Vedic astrology based on a 120-year planetary cycle. By providing birth details and a target date and time, you can determine which planetary periods are active at that moment.

The API returns six levels of planetary periods: Maha Dasa, Antar Dasa, Pratyantar Dasa, Sookshma Antar Dasa, Praana Antar Dasa, and Deha Antar Dasa. For each level, the response includes the ruling planet and the period's start and end timestamps, helping developers present detailed Dasha timelines and analyze planetary influences across different time scales.

This endpoint is useful for building Vedic astrology applications, horoscope analysis tools, Dasha prediction systems, and personalized astrology reports. Provide the native's birth date, time, latitude, longitude, and timezone, along with the target date and time in the event_data object. 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 results in JSON format for easy integration into web applications, mobile apps, and astrology software.

Request Parameters

Request Example

{
    "year": 1995,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 16.51666666666667,
    "longitude": 80.61666666666667,
    "timezone": 5.5,
    "config": {
        "observation_point": "geocentric", /* geocentric / topocentric */
        "ayanamsha": "sayana" /* lahiri / sayana */
    },
    "event_data": {
        "year": 2025,
        "month": 1,
        "date": 22,
        "hours": 9,
        "minutes": 30,
        "seconds": 0
    }
}

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "output": "{\"maha_dasa\": {\"Lord\": \"Rahu\", \"start_time\": \"2013-05-30 00:04:09.302029\", \"end_time\": \"2031-05-30 14:49:06.594829\"}, \"antar_dasa\": {\"Lord\": \"Venus\", \"start_time\": \"2024-12-16 17:08:00.064909\", \"end_time\": \"2027-12-17 11:35:29.613709\"}, \"pratyantar_dasa\": {\"Lord\": \"Venus\", \"start_time\": \"2024-12-16 17:08:00.064909\", \"end_time\": \"2025-06-17 08:12:34.989709\"}, \"sookshma_antar_dasa\": {\"Lord\": \"Sun\", \"start_time\": \"2025-01-16 03:38:45.885709\", \"end_time\": \"2025-01-25 06:47:59.631949\"}, \"praana_antar_dasa\": {\"Lord\": \"Mercury\", \"start_time\": \"2025-01-21 22:26:36.591661\", \"end_time\": \"2025-01-23 05:29:25.039045\"}, \"deha_antar_dasa\": {\"Lord\": \"Venus\", \"start_time\": \"2025-01-22 04:39:10.281137\", \"end_time\": \"2025-01-22 09:49:38.355701\"}}"
}

Code Examples

Use the following examples to integrate this API into your application.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/vimsottari/dasa-information',
  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": 1995,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 16.51666666666667,
    "longitude": 80.61666666666667,
    "timezone": 5.5,
    "config": {
        "observation_point": "geocentric", 
        "ayanamsha": "sayana" 
    },
    "event_data": {
        "year": 2025,
        "month": 1,
        "date": 22,
        "hours": 9,
        "minutes": 30,
        "seconds": 0
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "https://json.freeastrologyapi.com/vimsottari/dasa-information"

payload = json.dumps({
  "year": 1995,
  "month": 1,
  "date": 1,
  "hours": 10,
  "minutes": 30,
  "seconds": 31,
  "latitude": 16.51666666666667,
  "longitude": 80.61666666666667,
  "timezone": 5.5,
  "config": {
    "observation_point": "geocentric",
    "ayanamsha": "sayana"
  },
  "event_data": {
    "year": 2025,
    "month": 1,
    "date": 22,
    "hours": 9,
    "minutes": 30,
    "seconds": 0
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/vimsottari/dasa-information',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1995,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 16.51666666666667,
    "longitude": 80.61666666666667,
    "timezone": 5.5,
    "config": {
      "observation_point": "geocentric",
      "ayanamsha": "sayana"
    },
    "event_data": {
      "year": 2025,
      "month": 1,
      "date": 22,
      "hours": 9,
      "minutes": 30,
      "seconds": 0
    }
  })

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