POST/v1/astro/matchmaking/dashakoot

Dashakoot — 10-Koota Compatibility

Scores the South Indian Dashakoot match out of 10: ten poruthams, each 1 when it agrees and 0 when it does not. The poruthams are Dina, Gana, Mahendra, Stree Deergha, Yoni, Rasi, Rasi Adhipati, Vashya, Rajju and Vedha. Returns the per-porutham breakdown, the percentage, a compatibility level (Excellent 8+, Good 6+, Average 5+, otherwise Poor), and Nadi, Bhakoot, Rajju and Vedha dosha flags. Nadi and Bhakoot are reported but not scored.

Request parameters

person1required

object

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

person1.nameoptional

string

Person name associated with the birth record

person1.daterequired

string

Birth date in YYYY-MM-DD format

person1.timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

person1.latitudeoptional

number | null

Latitude. Required if location not provided.

person1.longitudeoptional

number | null

Longitude. Required if location not provided.

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

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

person1.ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

person2required

object

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

person2.nameoptional

string

Person name associated with the birth record

person2.daterequired

string

Birth date in YYYY-MM-DD format

person2.timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

person2.latitudeoptional

number | null

Latitude. Required if location not provided.

person2.longitudeoptional

number | null

Longitude. Required if location not provided.

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

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

person2.ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.birth_time_provided

boolean

True only when both people supplied a birth time. See person1_birth_time_provided and person2_birth_time_provided.

data.person1_birth_time_provided

boolean

True when person 1 supplied a birth time.

data.person2_birth_time_provided

boolean

True when person 2 supplied a birth time.

data.total_score

number

data.max_score

number

data.percentage

number

data.compatibility_level

string

data.breakdown

object

data.max_per_koota

object

data.doshas

object

data.doshas.nadi_dosha

boolean

data.doshas.nadi_cancelled

boolean

data.doshas.bhakoot_dosha

boolean

data.doshas.bhakoot_cancelled

boolean

data.doshas.rajju_dosha

boolean

data.doshas.rajju_group_boy

string | null

data.doshas.rajju_group_girl

string | null

data.doshas.vedha_dosha

boolean

data.doshas.vedha_pair

string | null

data.supplementary

object

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

• Kerala Porutham — 10-Porutham Compatibility
• Kundali Milan — Matchmaking
• Papasamyam — Malefic Planet Compatibility
• Thirumana Porutham (12 Poruthams)

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/matchmaking/dashakoot" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"},"person2":{"date":"1988-03-24","time":"14:30","latitude":28.6139,"longitude":77.209,"timezone":"Asia/Kolkata"}}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.dashakoot_request import DashakootRequest

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

request = DashakootRequest(
    person1={'date': '1985-11-12', 'time': '06:45', 'latitude': 19.076, 'longitude': 72.8777, 'timezone': 'Asia/Kolkata'},
    person2={'date': '1988-03-24', 'time': '14:30', 'latitude': 28.6139, 'longitude': 77.209, 'timezone': 'Asia/Kolkata'},
)

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

TypeScript

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

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

const result = await matchmakingDashakoot({
  client,
  body: {
      "person1": {
        "date": "1985-11-12",
        "time": "06:45",
        "latitude": 19.076,
        "longitude": 72.8777,
        "timezone": "Asia/Kolkata"
      },
      "person2": {
        "date": "1988-03-24",
        "time": "14:30",
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
      }
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "total_score": 7.0,
    "max_score": 10.0,
    "percentage": 70.0,
    "compatibility_level": "Good",
    "breakdown": {
      "Dina": 1.0,
      "Gana": 1.0,
      "Mahendra": 0.0,
      "StreeDeergha": 0.0,
      "Yoni": 1.0,
      "Rasi": 0.0,
      "RasiAdhipati": 1.0,
      "Vashya": 1.0,
      "Rajju": 1.0,
      "Vedha": 1.0
    },
    "max_per_koota": {
      "Dina": 1.0,
      "Gana": 1.0,
      "Mahendra": 1.0,
      "StreeDeergha": 1.0,
      "Yoni": 1.0,
      "Rasi": 1.0,
      "RasiAdhipati": 1.0,
      "Vashya": 1.0,
      "Rajju": 1.0,
      "Vedha": 1.0
    },
    "doshas": {
      "nadi_dosha": false,
      "nadi_cancelled": false,
      "bhakoot_dosha": true,
      "bhakoot_cancelled": true,
      "rajju_dosha": false,
      "rajju_group_boy": "Kantha",
      "rajju_group_girl": "Siro",
      "vedha_dosha": false,
      "vedha_pair": null
    },
    "supplementary": {
      "mahendra": {
        "is_auspicious": false,
        "distance": 11,
        "description": "Mahendra is not favorable — no major harm, but this factor is neutral."
      },
      "stree_deergha": {
        "distance": 11,
        "is_favorable": false,
        "description": "Inclusive count bride→groom = 11 (≤15 fail)."
      },
      "rajju": {
        "boy_rajju": "Kantha",
        "girl_rajju": "Siro",
        "same_rajju": false,
        "is_dosha": false,
        "description": "Different Rajju groups — no dosha from Rajju."
      },
      "vedha": {
        "has_vedha": false,
        "boy_nakshatra": 14,
        "girl_nakshatra": 4,
        "description": "No Vedha — Nakshatras are not mutually obstructive."
      },
      "dina_inclusive_count": 11
    }
  }
}