Dashakoot

Endpoint POST https://starsapi.com/api/v3/vedic/matchmaking/dashakoot

Returns the full Dashakoot (10-koota) porutham table — the South Indian marriage compatibility system used in Tamil, Kerala, and Karnataka traditions. Scores Dina, Gana, Yoni, Rasi, Rasyadhipati, Rajju, Vedha, Vashya, Mahendra, and Sthree Deergha.

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
`person1`	object	Yes	First person’s birth data (see fields below).
`person2`	object	Yes	Second person’s birth data (same fields).
Each person object:
`name`	string	No	Echoed in the response and used to personalize analysis text. Falls back to Bride/Groom or Person 1/Person 2.
`gender`	string	No	`male` or `female` — determines bride/groom role assignment.
`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.
Optional (top-level):
`ayanamsa`	string	No	Default `lahiri`.
`node_type`	string	No	`mean` (default) or `true`.

Response shape

Birth input is not echoed back in the response. The roles block maps each person to their bride/groom role (derived from gender; defaults to person1 = bride).

kutas[]

Field	Type	Description
`koot`	string	Koota name in Title Case (Dina, Gana, Yoni, Rasi, Rasyadhipati, Rajju, Vedha, Vashya, Mahendra, Sthree Deergha).
`area`	string	Life area (Destiny, Temperament, Intimacy, Prosperity, Mind, Longevity, Affliction, Attraction, Progeny, Protection).
`person1` / `person2`	string	Each person’s classification (null for pair-level kootas like Mahendra).
`obtained`	number	Points scored.
`max`	integer	Maximum possible.
`dosha`	boolean	Whether a dosha exists.

summary

Same shape as Ashtakoot: total_points, max_points, percentage, verdict.

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_GENDER`	Gender not male/female/m/f.
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/matchmaking/dashakoot" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "person1": {
            "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"
        },
        "person2": {
            "name": "Rahul",
            "gender": "male",
            "year": 1992,
            "month": 8,
            "day": 15,
            "hour": 10,
            "minute": 0,
            "second": 0,
            "latitude": 19.076,
            "longitude": 72.8777,
            "timezone": "Asia/Kolkata"
        }
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/matchmaking/dashakoot',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      person1: 'Array',
      person2: 'Array'
    })
  }
);
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/matchmaking/dashakoot',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'person1': 'Array',
        'person2': 'Array'
    }
)
result = response.json()

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

<?php
$payload = [
    'person1' => 'Array',
    'person2' => 'Array',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/matchmaking/dashakoot');
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/matchmaking/dashakoot'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'person1': 'Array',
      'person2': 'Array',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/matchmaking/dashakoot"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "person1": {
                "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"
            },
            "person2": {
                "name": "Rahul",
                "gender": "male",
                "year": 1992,
                "month": 8,
                "day": 15,
                "hour": 10,
                "minute": 0,
                "second": 0,
                "latitude": 19.076,
                "longitude": 72.8777,
                "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 = """
    {
        "person1": {
            "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"
        },
        "person2": {
            "name": "Rahul",
            "gender": "male",
            "year": 1992,
            "month": 8,
            "day": 15,
            "hour": 10,
            "minute": 0,
            "second": 0,
            "latitude": 19.076,
            "longitude": 72.8777,
            "timezone": "Asia/Kolkata"
        }
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/matchmaking/dashakoot")
        .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{}{
        "person1": "Array",
        "person2": "Array",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/matchmaking/dashakoot",
        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/matchmaking/dashakoot')
payload = {
  'person1' => 'Array',
  'person2' => 'Array'
}

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": {
    "roles": { "person1": "bride", "person2": "groom" },
    "summary": { "total_points": 16.5, "max_points": 36, "percentage": 45.8, "verdict": "Average match" },
    "kutas": [
      { "koot": "Dina", "area": "Destiny", "person1": "Mitra", "person2": "Vipat", "obtained": 1.5, "max": 3, "dosha": false },
      { "koot": "Gana", "area": "Temperament", "person1": "Manushya", "person2": "Rakshasa", "obtained": 0, "max": 4, "dosha": false },
      { "koot": "Yoni", "area": "Intimacy", "person1": "Cow", "person2": "Horse", "obtained": 2, "max": 4, "dosha": false },
      { "koot": "Rasi", "area": "Prosperity", "person1": "Pisces", "person2": "Aquarius", "obtained": 0, "max": 7, "dosha": true },
      { "koot": "Rasyadhipati", "area": "Mind", "person1": "Jupiter", "person2": "Saturn", "obtained": 3, "max": 5, "dosha": false },
      { "koot": "Rajju", "area": "Longevity", "person1": "Kati (Waist)", "person2": "Kantha (Neck)", "obtained": 5, "max": 5, "dosha": false },
      { "koot": "Vedha", "area": "Affliction", "person1": "Uttara Bhadrapada", "person2": "Shatabhisha", "obtained": 2, "max": 2, "dosha": false },
      { "koot": "Vashya", "area": "Attraction", "person1": "Jalachara", "person2": "Manava", "obtained": 1, "max": 2, "dosha": false },
      { "koot": "Mahendra", "area": "Progeny", "person1": null, "person2": null, "obtained": 0, "max": 2, "dosha": false },
      { "koot": "Sthree Deergha", "area": "Protection", "person1": null, "person2": null, "obtained": 2, "max": 2, "dosha": false }
    ]
  },
  "meta": { "endpoint": "/api/v3/vedic/matchmaking/dashakoot", "version": "3.0", "ayanamsa": { "name": "Lahiri", "value": 24.228335 }, "node_type": "mean" }
}