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
