Current Yogini Dasha By Date API

Current Yogini Dasha By Date

Returns the active Yogini Dasha state for a given natal chart at a caller-specified target date — the date-parameterized variant of the Current Yogini Dasha endpoint. Rather than resolving the active Yogini periods as of the server's current moment, this endpoint accepts an explicit target date (cDay, cMonth, cYear) in the request body, enabling Yogini Dasha state lookups for any past, present, or future date. This makes it the most flexible entry point for Yogini Dasha analysis when the target date needs to be explicitly controlled.

What This API Does

This endpoint accepts an individual's birth details along with a target date supplied in the request body, and computes the active Yogini Dasha state at both the major period and Antardasha levels as of that specified date. It identifies the major Yogini and Antardasha Yogini running on the target date, determines which cycle repetition of the 36-year Yogini cycle the major period belongs to, and evaluates the natal chart condition of both active Yogini lords. The response includes the inter-Yogini planetary relationship between the two active lords, the time remaining in each active period from the target date, and upcoming transition information — providing a complete, date-anchored Yogini Dasha snapshot in a single response.

Data Returned

The response provides the full active Yogini Dasha state as of the specified target date:

• Active major Yogini Dasha on target date — the major Yogini period running on the specified date, including the Yogini name, associated ruling planet, cycle number, and the major period's start and end dates

• Active Antardasha on target date — the Antardasha sub-period running on the specified date within the active major Yogini Dasha, including the sub-Yogini name, associated ruling planet, and the Antardasha's start and end dates

• Associated planet natal positions — the zodiac sign, degree, house placement, nakshatra, and dignity of the ruling planets associated with both the active major Yogini and the active Antardasha Yogini in the natal chart

• Inter-Yogini relationship assessment — an evaluation of the planetary relationship between the active major Yogini's ruling planet and the active Antardasha Yogini's ruling planet on the target date

• Period remaining from target date — the time remaining in both the active major Yogini period and the active Antardasha sub-period as of the specified target date, providing transition timing relative to that date

• Upcoming transitions — the identity of the next Yogini at both the major period and Antardasha levels following the target date, along with the dates of those upcoming transitions

• Cycle reference — the cycle number of the active major Yogini period on the target date, indicating which repetition of the 36-year cycle the individual is in on that date

• Nakshatra reference — the natal Moon's nakshatra and balance at birth, which anchors the entire Yogini Dasha timeline

Main Use Cases

• Future Yogini Dasha planning — determining the active major Yogini and Antardasha that will be running on a specific future date, enabling practitioners and clients to understand the Yogini period context for upcoming events, decisions, or milestones

• Historical Yogini Dasha analysis — resolving the active Yogini Dasha state on a specific past date to correlate life events with the Yogini periods running at the time, deepening interpretive understanding of the system

• Jyotish practitioners — quickly establishing the Yogini Dasha context for any date a client asks about — past, present, or future — without navigating the full timeline or manually calculating which Yogini periods were active on that date

• Astrology platforms and apps — powering date-picker Yogini Dasha lookup features that allow users to select any date on a calendar and instantly see the active major Yogini and Antardasha on that day

• Yogini transition planning — checking the Yogini Dasha state on specific upcoming dates to identify when major or sub-period transitions will occur, helping clients prepare for shifts in their Yogini period context

• Cross-system date-specific analysis — combining the Yogini Dasha state on a target date with the Vimshottari Dasha state on the same date (via Current Vimshottari Dasha By Date) to perform a complete dual-system dasha analysis for any specified date

• Automated report generation — providing the Yogini Dasha state for any specified date as a structured data input for report generation pipelines that need period context for a particular date rather than the current moment

Key Functionality

• Accepts a caller-specified target date (cDay, cMonth, cYear) in the request body, enabling Yogini Dasha state resolution for any past, present, or future date — the defining differentiator from the Current Yogini Dasha endpoint, which is fixed to the server's current moment

• Resolves the complete two-level active Yogini Dasha state for the target date — major Yogini period and Antardasha — in a single request, without requiring sequential calls

• Returns only the active periods on the target date at both levels, keeping the response compact and immediately actionable

• Includes period remaining from the target date at both levels, providing transition timing data relative to the specified date rather than the current moment — useful for both future planning and historical analysis

• Returns upcoming transition information at both levels following the target date — the next Yogini and transition date for both the major period and Antardasha — enabling forward-looking awareness from any specified date

• Identifies the cycle number of the active major Yogini period on the target date, disambiguating which repetition of the 36-year cycle the individual is in on that date

• Evaluates the inter-Yogini planetary relationship between the active major and sub-period lords on the target date, providing the key interpretive data point for assessing the two-level Yogini combination's quality

• Returns natal chart context for both active Yogini lords — sign, house, dignity, and nakshatra — so the date-specific snapshot is fully interpretively enriched

• Accepts birth details plus a target date in the request body with no path parameters required, keeping the interface simple while supporting the full range of date-specific lookups

• Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, since the Moon's nakshatra position — and therefore the entire Yogini Dasha timeline — varies by sidereal reference frame

• Designed for localization — the Accept-Language header controls the language of Yogini names, planet names, nakshatra names, relationship labels, and all descriptive content in the response

• Serves as the date-flexible complement to the Current Yogini Dasha endpoint — use Current Yogini Dasha for real-time snapshots and this endpoint whenever the target date needs to be explicitly controlled, whether for past analysis, future planning, or any date other than the present moment