Current Char Dasha API

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