Current Char Dasha By Date API

Current Char Dasha By Date

The Current Char Dasha By Date API returns the active Char Dasha periods across all levels of the Jaimini hierarchy — major, antar, and pratyantar — as they stand on a user-specified target date, rather than today. By accepting both birth details and a separate reference date, this endpoint enables historical lookups, future dasha projections, and date-specific consolidated dasha snapshots in a single call.

What This API Does

This endpoint computes the active Char Dasha periods at every level of the hierarchy for a given person as of a specific date (cDay, cMonth, cYear). It combines the convenience of the Current Char Dasha endpoint — returning all active levels in one response — with the date flexibility of the By Date variants, allowing the caller to query the complete dasha state for any point in time: past, present, or future.

This makes it the most efficient endpoint for date-specific Char Dasha lookups, eliminating the need to call the Major, Antar, and Pratyantar endpoints separately and manually determine which periods were active on a given date.

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 active Char Dasha periods on the specified target date, which may include:

• Active Major Char Dasha sign on the target date, with its start date, end date, and remaining duration
• Active Antar Char Dasha sign on the target date, with its start date, end date, and remaining duration
• Active Pratyantar Char Dasha sign on the target date, 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 as of the target date
• The target date used for the calculation, echoed back for confirmation
• Any additional Jaimini-specific attributes associated with the active sign lords

Main Use Cases

• Future dasha planning: Querying upcoming dates to determine which dasha combination will be active during a planned event — such as a wedding, business launch, surgery, or travel — for advance astrological guidance
• Historical dasha analysis: Looking up the dasha state on a past date to correlate active sign lords with real-life events, outcomes, or turning points
• Date-specific astrological reports: Generating personalised Char Dasha snapshots for a chosen date, such as a birthday, anniversary, or significant milestone
• Dasha transition tracking: Identifying when a person transitions from one dasha combination to another around a target date, enabling precise change-point analysis
• Vedic astrology platforms: Powering date-picker features that display the full dasha context for any selected date on a user's profile or chart view

Key Functionality

• Accepts birth date, time, and geographic coordinates alongside a separate target date (cDay, cMonth, cYear) for flexible date-specific queries
• Returns the active dasha at all three levels (major, antar, pratyantar) for the specified date in a single call, with no path parameters required
• Supports past, present, and future date queries, enabling both retrospective and predictive use cases
• Provides elapsed and remaining duration for each active period as of the target date, enabling progress indicators and countdown features
• Acts as the most efficient date-specific entry point into Char Dasha analysis, combining full hierarchy coverage with date flexibility
• 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