POST · VEDIC

Dashakoot Summary

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

Returns a human-readable verdict for the Dashakoot system with match quality, recommendation, and key findings.

Authentication

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Query?api_key=am_live_xxxxxxxxxxxx

Request body

FieldTypeRequiredDescription
person1objectYesFirst person’s birth data (see fields below).
person2objectYesSecond person’s birth data (same fields).
Each person object:
namestringNoEchoed in the response and used to personalize analysis text. Falls back to Bride/Groom or Person 1/Person 2.
genderstringNomale or female — determines bride/groom role assignment.
yearintegerYesBirth year.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
Optional (top-level):
ayanamsastringNoDefault lahiri.
node_typestringNomean (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).

FieldTypeDescription
match_percentagenumberScore as percentage.
match_qualitystringQuality label.
verdictstringOne-line verdict.
is_recommendedbooleanWhether recommended.
key_findingsarrayKey observations.
consultationobjectrecommended, urgency, and reason.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEHour/minute/second out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
400INVALID_GENDERGender not male/female/m/f.
405METHOD_NOT_ALLOWEDNon-POST request.

See also