Current Vimshottari Dasha API

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.

What This API Does

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.

Data Returned

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

Main Use Cases

• 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

Key Functionality

• 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