Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Current Char Dasha

The Current Char Dasha API provides char dasha related data and calculations using Vedic Astrology principles. This endpoint is designed for astrology applications, kundli generation, horoscope platforms, and developer integrations requiring accurate JSON-based responses and scalable REST API access.

https://json.astroinsightapi.com/api/v1/dasha/char/current-dasha
Credit Cost
1 Credit
Avg Latency
~31ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

API Overview & Calculation Details

Methodology and astrological context for Current Char Dasha.

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

Request Parameters

Payload specifications for JSON request body.

application/json
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

Required & Optional Headers

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

Frequently Asked Questions

Comprehensive developer guidance for Current Char Dasha.

What is the Current Char Dasha API and what data does it provide?

The Current Char Dasha API provides authentic Char 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.

What input parameters are required to call Current Char Dasha?

The Current Char 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.

How many credits does the Current Char Dasha endpoint consume?

Each calculation request to Current Char Dasha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~31ms.

How do I authenticate with the Current Char Dasha API?

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)).

Can I get Current Char Dasha responses in regional Indian languages?

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.

Which Ayanamsha systems can be calculated with Current Char Dasha?

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.

What response format and HTTP codes does this API return?

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.

POST dasha/char/current-dasha
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories