SEARCH ASTRO INSIGHT API DOCS
The Current Vimshottari Dasha API provides Vimshottari Dasha related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/dasha/vimshottari/current-dasha
en
hi
ma
Methodology and astrological context for Current Vimshottari Dasha.
Returns the complete active Vimshottari Dasha state for a given natal chart at the current moment — a convenience endpoint that resolves all five levels of the Vimshottari hierarchy simultaneously and returns only the periods that are presently running, rather than requiring the caller to navigate the full hierarchy level by level. This endpoint is the most practical entry point for real-time dasha analysis, providing an immediate snapshot of the full active dasha stack (Mahadasha, Antardasha, Pratyantardasha, Sookshma, and Pran) in a single call.
This endpoint accepts an individual's birth details and computes the currently active dasha period at every level of the Vimshottari hierarchy as of the moment the request is made. Rather than returning the full sequence of all periods at any given level, it resolves the single active period at each of the five levels — Mahadasha, Antardasha, Pratyantardasha, Sookshma Dasha, and Pran Dasha — and returns them together as a unified current dasha snapshot. It also evaluates the natal chart condition of each active dasha lord and the inter-lord relationships across all active levels, providing the interpretive context needed to immediately assess the quality and themes of the current planetary period stack without any additional calls.
The response provides the full active Vimshottari Dasha stack as of the time of the request:
Active Mahadasha — the currently running major period, including the governing planet, its natal position and condition, and the Mahadasha's start and end dates
Active Antardasha — the currently running sub-period within the active Mahadasha, including the governing planet, its natal position and condition, and the Antardasha's start and end dates
Active Pratyantardasha — the currently running sub-sub-period within the active Antardasha, including the governing planet, its natal position and condition, and the Pratyantardasha's start and end dates
Active Sookshma Dasha — the currently running sub-sub-sub-period within the active Pratyantardasha, including the governing planet, its natal position and condition, and the Sookshma Dasha's start and end dates
Active Pran Dasha — the currently running sub-sub-sub-sub-period within the active Sookshma Dasha, including the governing planet, its natal position and condition, and the Pran Dasha's precise start and end timestamps
Inter-lord relationship assessments — evaluations of the mutual relationships between all active dasha lords across the five levels, highlighting harmonious and conflicting planetary combinations in the current period stack
Dasha lord natal positions — the zodiac sign, degree, house placement, nakshatra, and dignity of each active dasha lord in the natal chart, providing the interpretive foundation for assessing each period's themes
Period remaining — the time remaining in each active period at every level, giving an immediate sense of how far into each period the individual currently is and when the next transition at each level will occur
Instant dasha snapshot — retrieving the complete active dasha state across all five levels in a single call, without needing to first call the Major Dasha endpoint, identify the active Mahadasha, then call the Antar Dasha endpoint, and so on through the hierarchy
Jyotish practitioners — quickly establishing the full current dasha context at the start of a client consultation, providing the complete five-level planetary period stack as an immediate reference for the reading
Astrology platforms and apps — powering real-time dasha dashboard widgets or home screen summaries that display a user's current dasha state at a glance, updated on each app open or session start
Notification and alert systems — using the period remaining data to trigger notifications when a user is approaching a dasha transition at any level, alerting them to upcoming shifts in their planetary period stack
Transit and event correlation — combining the current dasha stack with real-time planetary transits to assess how active transiting planets interact with the current dasha lords, enabling immediate combined dasha-transit analysis
Onboarding and orientation — serving as the first dasha call for new users of an astrology platform, giving them an immediate and complete picture of their current planetary period context before they explore the full dasha hierarchy in detail
Automated report generation — providing the current dasha state as a structured data input for automated natal report generation pipelines that need the active period stack without navigating the full hierarchy programmatically
Resolves the complete five-level active dasha stack in a single request — Mahadasha, Antardasha, Pratyantardasha, Sookshma, and Pran — eliminating the need for five sequential endpoint calls to establish the current dasha context
Returns only the currently active period at each level rather than the full sequence, making the response compact, immediately actionable, and directly interpretable without filtering or scanning
Includes period remaining at every level, providing transition timing data that is immediately useful for practitioners and end users without requiring manual date arithmetic
Evaluates inter-lord relationships across all five active levels simultaneously, giving a holistic picture of the current dasha stack's internal harmony or tension in a single response
Returns natal chart context for every active dasha lord — sign, house, dignity, and nakshatra — so the current dasha snapshot is fully interpretively enriched rather than being a bare list of planet names and dates
Accepts only birth details (date, time, and place of birth) with no path parameters or current location required — the server determines the current moment automatically, keeping the request payload minimal
Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, since the Moon's nakshatra position — and therefore the entire dasha timeline — varies by sidereal reference frame
Designed for localization — the Accept-Language header controls the language of planet names, nakshatra names, relationship labels, and all descriptive content in the response
Serves as the practical real-time entry point into the Vimshottari Dasha endpoint suite, complementing the full hierarchical endpoints (Major, Antar, Pratyantar, Sookshma, Pran) by providing an immediate current-state snapshot rather than a navigable timeline
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Current Vimshottari Dasha.
The Current Vimshottari Dasha API provides authentic Vimshottari Dasha calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Current Vimshottari Dasha API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Current Vimshottari Dasha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~34ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.