Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Current Yogini Dasha By Date

The Current Yogini Dasha By Date API provides yogini dasha related calculations and insights based on Vedic Astrology astrology data. This endpoint is designed for horoscope platforms, astrology applications, mobile apps, and developer integrations requiring accurate JSON responses and scalable REST API access.

https://json.astroinsightapi.com/api/v1/dasha/yogini/current-dasha-by-date
Credit Cost
1 Credit
Avg Latency
~56ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

API Overview & Calculation Details

Methodology and astrological context for Current Yogini Dasha By Date.

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

Request Parameters

Payload specifications for JSON request body.

application/json
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

Required & Optional Headers

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

Frequently Asked Questions

Comprehensive developer guidance for Current Yogini Dasha By Date.

What is the Current Yogini Dasha By Date API and what data does it provide?

The Current Yogini Dasha By Date API provides authentic Yogini 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.

What input parameters are required to call Current Yogini Dasha By Date?

The Current Yogini Dasha By Date 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.

How many credits does the Current Yogini Dasha By Date endpoint consume?

Each calculation request to Current Yogini Dasha By Date consumes 1 API credit. The endpoint delivers high performance with an average response time of ~56ms.

How do I authenticate with the Current Yogini Dasha By Date API?

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)).

Can I get Current Yogini Dasha By Date responses in regional Indian languages?

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.

Which Ayanamsha systems can be calculated with Current Yogini Dasha By Date?

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.

What response format and HTTP codes does this API return?

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.

POST dasha/yogini/current-dasha-by-date
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories