POST/v1/astro/char-dasha

Jaimini Char Dasha

Computes Jaimini Char Dasha — a sign-based dasha system from the Jaimini school of astrology. Returns mahadasha and antardasha periods starting from the ascendant (Lagna), with the current active mahadasha and antardasha highlighted. Method: K.N. Rao, as in his own dated case notes. The sequence runs forward when the 9th sign from the Lagna is savya (Aries, Taurus, Gemini, Libra, Scorpio, Sagittarius) and backward otherwise; period years count to the sign lord (savya forward, apasavya backward) minus one, 12 for the lord in its own rashi, with no year added or taken off for an exalted or debilitated lord (JHora's K.N. Rao option adds/subtracts one). Scorpio and Aquarius count to the co-lord outside the sign, or with both outside to the one with more planets, then the one further advanced. With cycles 2 or 3, every cycle repeats the first cycle's years. Antardashas are 12 equal parts (each as many months as the mahadasha has years); K.N. Rao: they run forward or backward by the 9th sign from the mahadasha sign (the same rule the Lagna uses), starting from the next sign, and the mahadasha sign's own antardasha comes last. Request JSON follows BirthInput plus cycles (1–3): name, date (YYYY-MM-DD), time (HH:MM, required), either location or latitude/longitude/timezone, ayanamsa.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timerequired

string

Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetoptional

string | null

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

cyclesoptional

integer

Dasha cycles to compute (1-3). K.N. Rao: every cycle repeats the first cycle's signs, order and years.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.birth_time_provided

boolean

True when a birth time was supplied. False when it was not: house, Ascendant and Moon-dependent results then carry the accuracy limits of an unknown birth time.

data.atmakaraka

string | null

data.start_rashi

string

data.start_rashi_index

integer

data.karakas

object

data.current_mahadasha

string | null

data.current_antardasha

string | null

data.periods

array[object]

data.periods[].rashi

string

data.periods[].rashi_index

integer

data.periods[].years

integer

Mahadasha length (K.N. Rao): signs counted from the rashi to its lord (forward for savya, backward for apasavya rashis) minus one, 12 when the lord is in the rashi; no year is added or taken off for an exalted or debilitated lord. Range 1–12. Scorpio and Aquarius: the co-lord outside the sign; with both outside, the one with more planets, then the one further advanced in its sign. Every cycle repeats the first cycle's years.

data.periods[].start_date

string

data.periods[].end_date

string

data.periods[].antardashas

array[object]

The 12 antardashas, each lasting as many months as the mahadasha has years (K.N. Rao). They run forward when the 9th sign from the mahadasha sign is savya (Aries, Taurus, Gemini, Libra, Scorpio, Sagittarius) and backward otherwise, starting from the next sign; the mahadasha sign's own antardasha is the last.

data.periods[].antardashas[].rashi

string

data.periods[].antardashas[].rashi_index

integer

data.periods[].antardashas[].years

integer

data.periods[].antardashas[].start_date

string

data.periods[].antardashas[].end_date

string

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Ashtottari Dasha
• Dasha-Transit Correlation
• Vimshottari Dasha
• Yogini Dasha

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/char-dasha" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.char_dasha_request import CharDashaRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = CharDashaRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.char_dasha(char_dasha_request=request)
    print(result)

TypeScript

import { createClient, createConfig, charDasha } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await charDasha({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "atmakaraka": "Sun",
    "start_rashi": "Tula",
    "start_rashi_index": 6,
    "karakas": {
      "Atmakaraka": "Sun",
      "Amatyakaraka": "Mercury",
      "Bhratrikaraka": "Moon",
      "Matrikaraka": "Mars",
      "Pitrikaraka": "Jupiter",
      "Putrakaraka": "Rahu",
      "Gnatikaraka": "Venus",
      "Darakaraka": "Saturn"
    },
    "current_mahadasha": "Vrishabha",
    "current_antardasha": "Vrishabha",
    "periods": [
      {
        "rashi": "Tula",
        "rashi_index": 6,
        "years": 12,
        "start_date": "1985-11-12",
        "end_date": "1997-11-12",
        "antardashas": [
          {
            "rashi": "Vrischika",
            "rashi_index": 7,
            "years": 11,
            "start_date": "1985-11-12",
            "end_date": "1986-11-12"
          },
          {
            "rashi": "Dhanu",
            "rashi_index": 8,
            "years": 1,
            "start_date": "1986-11-12",
            "end_date": "1987-11-12"
          },
          "... and 10 more items"
        ]
      },
      {
        "rashi": "Vrischika",
        "rashi_index": 7,
        "years": 11,
        "start_date": "1997-11-12",
        "end_date": "2008-11-12",
        "antardashas": [
          {
            "rashi": "Tula",
            "rashi_index": 6,
            "years": 12,
            "start_date": "1997-11-12",
            "end_date": "1998-10-12"
          },
          {
            "rashi": "Kanya",
            "rashi_index": 5,
            "years": 10,
            "start_date": "1998-10-12",
            "end_date": "1999-09-11"
          },
          "... and 10 more items"
        ]
      },
      "... and 10 more items"
    ]
  }
}