Match Making

POST /v1/matching

Performs Gun Milan (36-point compatibility analysis) between two profiles for marriage matching purposes. Analyzes aspects like Guna compatibility, Manglik dosha, Nadi dosha, and provides overall compatibility score.

Request body

Field	Type	Required	Description
brideProfileId	string	Yes	Bride's profile ID
groomProfileId	string	Yes	Groom's profile ID
locale	string	No	en · hi · ne (default: en)

Example

curl -X POST https://api.askvedicguru.com/api/v1/matching \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "brideProfileId": "683abc123def456",
    "groomProfileId": "683abc789abc012"
  }'

Response

{
  "success": true,
  "data": {
    "matching": {
      "bride": {
        "nakshatra": "Chitra",
        "rashi": "Virgo",
        "nakshatraPada": 2,
        "name": "Bride Name"
      },
      "groom": {
        "nakshatra": "Shatabhisha",
        "rashi": "Aquarius",
        "nakshatraPada": 3,
        "name": "Groom Name"
      },
      "ashtakoot": {
        "varna": {
          "name": "Varna",
          "maxPoints": 1,
          "obtainedPoints": 0,
          "description": "Vaishya (Virgo), Shudra (Aquarius)..."
        },
        "vashya": { "name": "Vashya", "maxPoints": 2, "obtainedPoints": 0.5 },
        "tara": { "name": "Tara", "maxPoints": 3, "obtainedPoints": 3 },
        "yoni": { "name": "Yoni", "maxPoints": 4, "obtainedPoints": 2 },
        "grahamaitri": { "name": "Grahamaitri", "maxPoints": 5, "obtainedPoints": 4 },
        "gana": { "name": "Gana", "maxPoints": 6, "obtainedPoints": 0 },
        "bhakoot": { "name": "Bhakoot", "maxPoints": 7, "obtainedPoints": 7 },
        "nadi": { "name": "Nadi", "maxPoints": 8, "obtainedPoints": 8 }
      },
      "totalPoints": 24.5,
      "maxPoints": 36,
      "percentage": 68.1,
      "manglikStatus": {
        "brideHasDosha": false,
        "groomHasDosha": false
      },
      "recommendation": "Match is favorable"
    },
    "summary": "Compatible based on Ashtakoot analysis"
  }
}

Compatibility levels

Score range	Level
28–36	Excellent
18–27	Good
12–17	Average
0–11	Poor