Vimshottari Sookshma Dasha

Endpoint POST https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma

Returns 9 Sookshma Dasha (subtle period) entries for a specific Pratyantardasha. Durations are in hours and timestamps include time-of-day (YYYY-MM-DD HH:MM).

Lazy-load chain
mahadasha → antardasha → pratyantardasha → sookshma → pran

Request body

All standard birth fields, plus:

Field	Type	Required	Description
`year`, `month`, `day`, `hour`, `minute`	integer	Yes	Birth date/time.
`latitude`, `longitude`	number	Yes	Decimal degrees.
`timezone`	string	Yes	IANA timezone.
`mahadasha`	string	Yes	Planet name.
`antardasha`	string	Yes	Planet name.
`pratyantardasha`	string	Yes	Planet name.

Ayanamsa & KP usage

Vimshottari periods are derived from the Moon’s nakshatra position, which shifts with the chosen ayanamsa. Lahiri and Krishnamurti (KP) differ by roughly 5–6 arc-minutes — enough to shift dasha start/end dates by several days, and at deeper levels (Sookshma/Pran) even change the running lord. KP practitioners should pass "ayanamsa": "krishnamurti" (alias kp); variants kp_new and kp_senthil are also supported. The ayanamsa actually used is echoed in the response meta for verification. Unknown ayanamsa names return an error rather than silently falling back to Lahiri.

Response shape

sookshma_dashas[]

9 entries. Note: dates include time (YYYY-MM-DD HH:MM) and duration is in hours.

Field	Type	Description
`planet`	string	Sookshma lord.
`start_date`	string	`YYYY-MM-DD HH:MM`.
`end_date`	string	`YYYY-MM-DD HH:MM`.
`duration_hours`	number	Duration in hours.
`is_balance`	boolean	`true` for balance period.

Next step

Add the tapped row’s planet as sookshma and call Pran Dasha.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent.
400	`INVALID_PARAM`	Invalid planet name.
400	`INVALID_DASHA_PATH`	Planet not found in dasha sequence.
405	`METHOD_NOT_ALLOWED`	Non-POST request.
500	`COMPUTE_ERROR`	Unknown `ayanamsa` name.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
        "mahadasha": "Jupiter",
        "antardasha": "Venus",
        "pratyantardasha": "Sun"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata',
      mahadasha: 'Jupiter',
      antardasha: 'Venus',
      pratyantardasha: 'Sun'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata',
        'mahadasha': 'Jupiter',
        'antardasha': 'Venus',
        'pratyantardasha': 'Sun'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
    'mahadasha' => 'Jupiter',
    'antardasha' => 'Venus',
    'pratyantardasha' => 'Sun',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
      'mahadasha': 'Jupiter',
      'antardasha': 'Venus',
      'pratyantardasha': 'Sun',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata",
            "mahadasha": "Jupiter",
            "antardasha": "Venus",
            "pratyantardasha": "Sun"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
        "mahadasha": "Jupiter",
        "antardasha": "Venus",
        "pratyantardasha": "Sun"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
        "mahadasha": "Jupiter",
        "antardasha": "Venus",
        "pratyantardasha": "Sun",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/dashas/vimshottari-sookshma')
payload = {
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata',
  'mahadasha' => 'Jupiter',
  'antardasha' => 'Venus',
  'pratyantardasha' => 'Sun'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "dasha_path": {
      "mahadasha": "Jupiter",
      "antardasha": "Venus",
      "pratyantardasha": "Sun"
    },
    "pratyantardasha_period": {
      "start_date": "2096-05-31 01:51",
      "end_date": "2096-07-18 18:39",
      "duration_days": 48.7
    },
    "sookshma_dashas": [
      {
        "planet": "Sun",
        "start_date": "2096-05-31 01:51",
        "end_date": "2096-06-02 12:18",
        "duration_hours": 58.44,
        "is_balance": false
      },
      {
        "planet": "Moon",
        "start_date": "2096-06-02 12:18",
        "end_date": "2096-06-06 13:42",
        "duration_hours": 97.4,
        "is_balance": false
      },
      {
        "planet": "Mars",
        "start_date": "2096-06-06 13:42",
        "end_date": "2096-06-09 09:52",
        "duration_hours": 68.18,
        "is_balance": false
      },
      {
        "planet": "Rahu",
        "start_date": "2096-06-09 09:52",
        "end_date": "2096-06-16 17:12",
        "duration_hours": 175.32,
        "is_balance": false
      },
      {
        "planet": "Jupiter",
        "start_date": "2096-06-16 17:12",
        "end_date": "2096-06-23 05:02",
        "duration_hours": 155.84,
        "is_balance": false
      },
      {
        "planet": "Saturn",
        "start_date": "2096-06-23 05:02",
        "end_date": "2096-06-30 22:06",
        "duration_hours": 185.06,
        "is_balance": false
      },
      {
        "planet": "Mercury",
        "start_date": "2096-06-30 22:06",
        "end_date": "2096-07-07 19:40",
        "duration_hours": 165.58,
        "is_balance": false
      },
      {
        "planet": "Ketu",
        "start_date": "2096-07-07 19:40",
        "end_date": "2096-07-10 15:51",
        "duration_hours": 68.18,
        "is_balance": false
      },
      {
        "planet": "Venus",
        "start_date": "2096-07-10 15:51",
        "end_date": "2096-07-18 18:39",
        "duration_hours": 194.8,
        "is_balance": false
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v3/vedic/dashas/vimshottari-sookshma",
    "version": "3.0",
    "response_time_ms": 2,
    "ayanamsa": {
      "name": "Lahiri",
      "value": 23.725957,
      "value_dms": "23°43'33\""
    },
    "node_type": "mean"
  }
}