Current Char Dasha
The Current Char Dasha API returns the currently active dasha periods across all levels of the Jaimini Char Dasha hierarchy for a person, based on their birth details and the present date. Rather than requiring the caller to navigate the hierarchy level by level, this endpoint delivers a consolidated snapshot of the active major, antar, and pratyantar dasha signs in a single response — making it the most efficient entry point for real-time Char Dasha status lookups.
What This API Does
This endpoint computes the person's active Char Dasha periods at every level of the hierarchy — major (Maha), sub-period (Antar), and sub-sub-period (Pratyantar) — as they stand right now, derived from the person's birth date, time, timezone, and geographic coordinates. Instead of calling the Major, Antar, and Pratyantar endpoints separately and cross-referencing results, this endpoint consolidates the current dasha state into a single, ready-to-use response.
The Ayanamsha system is configurable via the X-Ayanamsha header, and multi-language support is available through the Accept-Language header.
What Data It Returns
The response provides a complete snapshot of the currently running Char Dasha periods, which may include:
- Currently active Major Char Dasha sign, with its start date, end date, and remaining duration
- Currently active Antar Char Dasha sign within the major period, with its start date, end date, and remaining duration
- Currently active Pratyantar Char Dasha sign within the antar period, with its start date, end date, and remaining duration
- Zodiac sign names for each active dasha lord at every level
- Elapsed time and percentage completion for each active period
- Any additional Jaimini-specific attributes associated with the active sign lords
Main Use Cases
- Real-time dasha dashboards: Displaying a person's current dasha status at a glance — major, antar, and pratyantar — without requiring multiple API calls or manual hierarchy navigation
- Horoscope and daily guidance apps: Surfacing the active dasha context alongside planetary transits and other chart data to provide immediate, personalised astrological insights
- Predictive astrology consultations: Quickly establishing the current dasha backdrop for a reading, identifying which sign lords are active and what themes they bring
- Notifications and alerts: Triggering dasha-change notifications when a person transitions from one active period to another at any level of the hierarchy
- Vedic astrology platforms: Serving as the primary dasha status endpoint for user profiles, powering widgets, summaries, and overview screens
Key Functionality
- Accepts only birth date, time, and geographic coordinates (latitude, longitude, timezone) — no path parameters or additional inputs required
- Returns the currently active dasha at all three levels (major, antar, pratyantar) in a single call, eliminating the need for sequential hierarchy navigation
- Provides elapsed and remaining duration for each active period, enabling progress indicators and countdown features
- Acts as the most efficient entry point into Char Dasha analysis for real-time and user-facing applications
- Supports multiple Ayanamsha systems via the
X-Ayanamsha header for tradition-specific zodiac calculations
- Supports multi-language responses via the
Accept-Language header for localized applications
