SEARCH ASTRO INSIGHT API DOCS
The Antar Yogini Dasha 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/antar-dasha
en
hi
ma
Methodology and astrological context for Antar Yogini Dasha.
Returns the complete Antardasha (sub-period) breakdown within the Yogini Dasha system for a given natal chart — the second level of the Yogini Dasha hierarchy. Each major Yogini Dasha period is subdivided into eight Antardasha sub-periods, one for each of the eight Yoginis in sequence, with durations proportionally derived from the major period's length and each sub-Yogini's standard allocation within the cycle. The Yogini Antardasha level provides the finer timing resolution needed to identify specific windows within a major Yogini period when particular Yogini-governed sub-influences are active.
This endpoint accepts an individual's birth details and computes the complete Yogini Antardasha breakdown across the natal Yogini Dasha timeline. For each major Yogini Dasha period, it subdivides the period into eight Antardasha sub-periods following the Yogini sequence, calculates their precise start and end dates, and evaluates the natal chart condition of each sub-period's associated planet. The endpoint returns the full Antardasha structure — covering all major Yogini periods and their respective sub-period breakdowns — providing a comprehensive two-level Yogini Dasha timeline in a single response. It also identifies the currently active Antardasha within the currently running major Yogini period, giving an immediate real-time reference point within the two-level hierarchy.
The response provides the complete two-level Yogini Dasha timeline with Antardasha breakdowns:
Full Antardasha breakdown per major Yogini period — for each of the eight major Yogini Dasha periods, the complete ordered list of eight Antardasha sub-periods following the Yogini sequence, with Yogini name and associated planet for each sub-period
Period start and end dates — precise calendar dates marking the beginning and end of each Antardasha sub-period within every major Yogini period
Period duration — the length of each Antardasha in days and months, calculated proportionally from the major Yogini period's length and each sub-Yogini's standard allocation
Major Yogini period context — the identity, associated planet, natal position, and condition of each governing major Yogini, providing the overarching context within which all Antardashas operate
Sub-Yogini and associated planet details — the Yogini name and ruling planet for each Antardasha, along with the associated planet's natal position, house placement, dignity, and nakshatra
Inter-Yogini relationship assessment — evaluations of the relationship between the major Yogini's ruling planet and each Antardasha Yogini's ruling planet, informing whether the sub-period is likely to be harmonious or conflicting within the major period's themes
Currently active Antardasha — identification of which Antardasha sub-period is currently running within the currently active major Yogini Dasha, providing an immediate real-time reference
Nakshatra reference — the natal Moon's nakshatra and balance at birth, which anchors the entire Yogini Dasha timeline
Refined Yogini Dasha timing — narrowing the broad themes of a major Yogini period down to specific multi-month sub-period windows, enabling more precise event timing and prediction than major Yogini period analysis alone
Jyotish practitioners using the Yogini system — accessing the full two-level Yogini Dasha timeline in a single call to provide clients with a detailed breakdown of sub-period influences within each major Yogini period
Astrology platforms and apps — powering Yogini Dasha timeline features that display the Antardasha sub-period structure within each major Yogini period, allowing users to explore the two-level hierarchy for their natal chart
Current sub-period identification — quickly determining which Yogini Antardasha is currently active within the running major Yogini period, as a reference point for real-time analysis and consultation
Cross-system sub-period comparison — comparing the active Yogini Antardasha with the active Vimshottari Antardasha to identify periods where both systems highlight the same planetary influence at the sub-period level, increasing prediction confidence
Yogini sub-period quality assessment — using the inter-Yogini planetary relationship data to identify Antardasha sub-periods that are likely to be particularly favorable or challenging within each major Yogini period
Life event correlation at the sub-period level — mapping past events onto the Yogini Antardasha timeline to validate sub-period themes and deepen understanding of how the two-level Yogini hierarchy operates in practice
Returns the complete two-level Yogini Dasha timeline — all major Yogini periods with their full Antardasha breakdowns — in a single response, providing the entire two-level hierarchy without requiring separate calls per major period
Preserves Yogini identity at both levels — each major period and each Antardasha sub-period is identified by Yogini name and associated planet, maintaining the Yogini system's distinct interpretive framework rather than reducing it to a bare planetary period list
Calculates precise start and end dates for every Antardasha sub-period within every major Yogini period, enabling direct calendar mapping across the full two-level timeline
Evaluates the inter-Yogini planetary relationship between the major period's ruling planet and each Antardasha's ruling planet, providing the key interpretive data point for assessing sub-period quality within the Yogini framework
Identifies the currently active Antardasha within the currently running major Yogini period, providing an immediate real-time reference without requiring the caller to scan the full timeline
Returns natal chart context for each Yogini's associated planet at both levels — sign, house, dignity, and nakshatra — so the two-level timeline is fully interpretively enriched
Accepts only birth details (date, time, and place of birth) with no path parameters or current location required, since Yogini Dasha calculation is based entirely on the natal chart
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 second level of the Yogini Dasha hierarchy, providing the sub-period timing resolution needed for practical predictive work within the Yogini system, and intended to be used after the Major Yogini Dasha endpoint has established the major period context
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 Antar Yogini Dasha.
The Antar Yogini Dasha 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.
The Antar Yogini 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 Antar Yogini Dasha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~69ms.
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.