Chara Karakas

Endpoint POST https://starsapi.com/api/v3/vedic/jaimini/karakas

Returns the Chara (movable) Karakas — the soul-level significators of Jaimini astrology, assigned by sorting the planets by degrees traversed in their signs. The planet with the highest degree becomes the Atmakaraka (soul significator), descending through Amatyakaraka to Darakaraka. Supports the classical 7-karaka scheme (default), the 8-karaka scheme (with Rahu counted in reverse: 30° minus its degree), and "scheme": "both" to fetch both schemes in a single call.

Authentication

Method	Example
Header (recommended)	`X-Api-Key: sa_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer sa_live_xxxxxxxxxxxx`
Query	`?api_key=sa_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`.
`scheme`	integer \| string	No	`7` (default, classical), `8` (with Rahu), or `"both"` — returns both schemes in one response.

Response shape

Field	Type	Description
`karaka_scheme`	integer \| string	`7`, `8`, or `"both"` (echoes the requested scheme).
`seven_planet` / `eight_planet`	object	Present only when `scheme` is `"both"`: each holds `total_karakas`, `chara_karakas[]`, and `karaka_sorting`. The top-level `total_karakas`/`chara_karakas` are omitted in this mode.
`chara_karakas[]`	array	In karaka order: AK, AmK, BK, MK, PiK, PuK, GK, DK (8-scheme); the 7-scheme omits PuK (the Matrikaraka doubles as Putrakaraka).
`chara_karakas[].planet` / `sorting_degree`	mixed	The planet and the degree used for ranking (for Rahu: 30 − degree in sign).
`chara_karakas[].sign` / `sign_hindi` / `navamsa_sign` / `nakshatra`	mixed	Full positional context for each karaka.

Fetching both schemes

Pass "scheme": "both" to get the 7- and 8-karaka rankings in one call — planetary positions are computed once, so it costs the same as a single-scheme request:

{
  "karaka_scheme": "both",
  "seven_planet": { "total_karakas": 7, "chara_karakas": [ ... ], "karaka_sorting": { ... } },
  "eight_planet": { "total_karakas": 8, "chara_karakas": [ ... ], "karaka_sorting": { ... } }
}

Karaka order — 7-scheme: AK, AmK, BK, MK, PiK, GK, DK. 8-scheme: AK, AmK, BK, MK, PiK, PuK (Rahu-inclusive), GK, DK. Each row uses the same shape documented above.

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/karakas" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Priya",
        "gender": "female",
        "year": 1990,
        "month": 5,
        "day": 15,
        "hour": 10,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/jaimini/karakas',
  {
    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: 15,
      hour: 10,
      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/karakas',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'name': 'Priya',
        'gender': 'female',
        'year': 1990,
        'month': 5,
        'day': 15,
        'hour': 10,
        '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' => 15,
    'hour' => 10,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/jaimini/karakas');
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/karakas'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'name': 'Priya',
      'gender': 'female',
      'year': 1990,
      'month': 5,
      'day': 15,
      'hour': 10,
      '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/karakas"
    )!)
    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": 15,
            "hour": 10,
            "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": 15,
        "hour": 10,
        "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/karakas")
        .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": 15,
        "hour": 10,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/jaimini/karakas",
        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/karakas')
payload = {
  'name' => 'Priya',
  'gender' => 'female',
  'year' => 1990,
  'month' => 5,
  'day' => 15,
  'hour' => 10,
  '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",
    "karaka_scheme": 7,
    "total_karakas": 7,
    "chara_karakas": [
      {
        "karaka": "Atmakaraka",
        "abbreviation": "AK",
        "planet": "Moon",
        "longitude": 269.8424,
        "longitude_dms": "269\u00b050'33\"",
        "sign": "Sagittarius",
        "sign_hindi": "Dhanu",
        "sign_number": 9,
        "degree_in_sign": 29.8424,
        "degree_in_sign_dms": "29\u00b050'33\"",
        "sorting_degree": 29.8424,
        "house_from_lagna": 6,
        "nakshatra": "Uttara Ashadha",
        "nakshatra_pada": 1,
        "nakshatra_lord": "Sun",
        "navamsa_sign": "Sagittarius",
        "navamsa_sign_hindi": "Dhanu",
        "navamsa_sign_number": 9,
        "is_retrograde": false,
        "significance": "Soul, Self, King of the chart"
      },
      {
        "karaka": "Amatyakaraka",
        "abbreviation": "AmK",
        "planet": "Mars",
        "longitude": 324.3914,
        "longitude_dms": "324\u00b023'29\"",
        "sign": "Aquarius",
        "sign_hindi": "Kumbha",
        "sign_number": 11,
        "degree_in_sign": 24.3914,
        "degree_in_sign_dms": "24\u00b023'29\"",
        "sorting_degree": 24.3914,
        "house_from_lagna": 8,
        "nakshatra": "Purva Bhadrapada",
        "nakshatra_pada": 2,
        "nakshatra_lord": "Jupiter",
        "navamsa_sign": "Taurus",
        "navamsa_sign_hindi": "Vrishabha",
        "navamsa_sign_number": 2,
        "is_retrograde": false,
        "significance": "Career, Profession, Minister"
      }
    ],
    "karaka_sorting": {
      "method": "descending_longitude_degrees_in_sign",
      "note": "Planets sorted by degrees traversed in their sign (highest = AK, lowest = DK). For Rahu, 30 minus degree is used."
    }
  },
  "meta": { "endpoint": "/api/v3/vedic/jaimini/karakas", "version": "3.0", "ayanamsa": { "name": "Lahiri", "value": 23.725957 }, "node_type": "mean" }
}