Chara Dasha

Endpoint POST https://starsapi.com/api/v3/vedic/jaimini/chara-dasha

Returns the Jaimini Chara Dasha — the sign-based dasha system. Direction follows the Lagna (odd signs zodiacal, even signs anti-zodiacal in the classical footed scheme); each sign’s duration is the count from the sign to its lord (forward for signs 1–3 and 7–9, reverse for 4–6 and 10–12), minus one, with the lord in its own sign giving 12 years. Scorpio and Aquarius use dual lordship (Mars/Ketu, Saturn/Rahu) resolved by classical strength rules, with degree-strength as the decider when both lords sit outside the sign — verified against standard professional references. Antardashas follow the classical sub-period direction rules.

Authentication

Method	Example
Header (recommended)	`X-Api-Key: am_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer am_live_xxxxxxxxxxxx`
Query	`?api_key=am_live_xxxxxxxxxxxx`

Request body

Field	Type	Required	Description
`name`	string	No	Echoed in the response.
`year`	integer	Yes	Birth year.
`month`	integer	Yes	Birth month, 1–12.
`day`	integer	Yes	Day of month.
`hour`	integer	Yes	Hour, 24-hour.
`minute`	integer	Yes	Minute.
`second`	integer	No	Default `0`.
`latitude`	number	Yes	Decimal degrees.
`longitude`	number	Yes	Decimal degrees.
`timezone`	string	Yes	IANA timezone.
`ayanamsa`	string	No	Default `lahiri`.
`node_type`	string	No	`mean` (default) or `true`.
`levels`	integer	No	Dasha depth: 1 (mahadashas), 2 (with antardashas), or 3. Default 3.

Response shape

Field	Type	Description
`calculation_method`	object	Lagna type, direction, and duration method used.
`dasha_sequence[]`	array	All 12 mahadashas: `sign`, `duration_years`, `start_date`, `end_date`, nested antardashas per the requested depth.
`current_dasha`	object	The running rashi dasha and antardasha with dates.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent.
400	`INVALID_DATE`	Bad calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Lat/lon out of range.
400	`INVALID_PARAM`	Bad ayanamsa, node_type, or scheme.
405	`METHOD_NOT_ALLOWED`	Non-POST request.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/jaimini/chara-dasha" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Priya",
        "gender": "female",
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/jaimini/chara-dasha',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Priya',
      gender: 'female',
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/jaimini/chara-dasha',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'name': 'Priya',
        'gender': 'female',
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'name' => 'Priya',
    'gender' => 'female',
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/jaimini/chara-dasha');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/jaimini/chara-dasha'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'name': 'Priya',
      'gender': 'female',
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/jaimini/chara-dasha"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "name": "Priya",
            "gender": "female",
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "name": "Priya",
        "gender": "female",
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/jaimini/chara-dasha")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "name": "Priya",
        "gender": "female",
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/jaimini/chara-dasha",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/jaimini/chara-dasha')
payload = {
  'name' => 'Priya',
  'gender' => 'female',
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "name": "Priya",
    "dasha_system": "Jaimini Chara Dasha",
    "calculation_method": {
      "basis": "Sign-based dasha, order depends on whether Lagna is odd or even sign",
      "lagna_sign": "Kanya",
      "lagna_sign_en": "Virgo",
      "duration_method": "Based on distance of sign lord from the sign"
    },
    "dasha_sequence": [
      { "sign": "Virgo", "duration_years": 5, "start_date": "1990-05-20", "end_date": "1995-05-20" },
      { "sign": "Libra", "duration_years": 5, "start_date": "1995-05-20", "end_date": "2000-05-20" },
      { "sign": "Scorpio", "duration_years": 3, "start_date": "2000-05-20", "end_date": "2003-05-20" }
    ],
    "current_dasha": {
      "rashi_dasha": { "sign": "Pisces", "sign_lord": "Jupiter", "start_date": "2022-05-20", "end_date": "2031-05-20" },
      "antardasha": { "sign": "Virgo", "sign_lord": "Mercury", "start_date": "2026-02-17", "end_date": "2026-11-17" }
    }
  },
  "meta": { "endpoint": "/api/v3/vedic/jaimini/chara-dasha", "version": "3.0", "ayanamsa": { "name": "Lahiri", "value": 23.725957 }, "node_type": "mean" }
}