POST

/v1/compatibility/match

Comprehensive Kundali matching for marriage compatibility using traditional Vedic astrology methods including Ashtakoot system, Manglik analysis, and detailed compatibility reports.

Ashtakoot Matching System

The Ashtakoot (36 points) system evaluates compatibility across eight essential categories that determine the success and harmony of married life.

वर्ण (Varna) - 1 Point

Spiritual compatibility and working nature

वश्या (Vashya) - 2 Points

Magnetic control and dominance factor

तारा (Tara) - 3 Points

Longevity and prosperity through Nakshatra matching

यौनि (Yoni) - 4 Points

Sexual compatibility and physical harmony

ग्रह मैत्री (Graha Maitri) - 5 Points

Planetary friendship and mental compatibility

गण (Gana) - 6 Points

Temperament and behavioral compatibility

भकूट (Bhakoot) - 7 Points

Love and emotional bonding

नाड़ी (Nadi) - 8 Points

Health and progeny (most important factor)

Request Body

{
  "boy": {
    "date": "1995-06-15T14:30:00Z",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": 5.5,
    "name": "Rahul Sharma"
  },
  "girl": {
    "date": "1997-03-22T10:15:00Z",
    "latitude": 27.7172,
    "longitude": 85.3240,
    "timezone": 5.75,
    "name": "Priya Thapa"
  },
  "system": "ashtakoot",
  "includeRemedies": true,
  "detailedReport": true
}

Complete Compatibility Report

{
  "compatibility": {
    "overallScore": 28,
    "maximumScore": 36,
    "percentage": 77.8,
    "result": "Good Match",
    "recommendation": "Proceed with marriage after remedies"
  },
  "ashtakoot": {
    "varna": { "score": 1, "maxScore": 1, "status": "Excellent" },
    "vashya": { "score": 1, "maxScore": 2, "status": "Good" },
    "tara": { "score": 2, "maxScore": 3, "status": "Good" },
    "yoni": { "score": 3, "maxScore": 4, "status": "Good" },
    "grahaMaitri": { "score": 4, "maxScore": 5, "status": "Good" },
    "gana": { "score": 3, "maxScore": 6, "status": "Average" },
    "bhakoot": { "score": 5, "maxScore": 7, "status": "Good" },
    "nadi": { "score": 0, "maxScore": 8, "status": "Problematic" }
  },
  "manglik": {
    "boy": { "isManglik": false, "dosha": "No Dosha" },
    "girl": { "isManglik": true, "dosha": "High Manglik" },
    "compatibility": "Requires Remedies"
  }
}

{
  "detailedAnalysis": {
    "varna": {
      "boy": "Brahmin (Priest/Intellectual)",
      "girl": "Kshatriya (Warrior/Leader)",
      "compatibility": "Good spiritual harmony",
      "score": 1
    },
    "vashya": {
      "boy": "Human",
      "girl": "Quadruped",
      "compatibility": "Balanced control",
      "score": 1
    },
    "tara": {
      "boyNakshatra": "Rohini",
      "girlNakshatra": "Ashwini",
      "compatibility": "Benefic combination",
      "score": 2
    },
    "yoni": {
      "boy": "Horse (fast, loyal)",
      "girl": "Elephant (strong, stable)",
      "compatibility": "Complementary energies",
      "score": 3
    },
    "grahaMaitri": {
      "compatibility": "Friendly planets",
      "description": "Mental harmony exists",
      "score": 4
    },
    "gana": {
      "boy": "Manushya (human-like)",
      "girl": "Dev (divine)",
      "compatibility": "Different temperaments",
      "score": 3
    },
    "bhakoot": {
      "houseDifference": 4,
      "compatibility": "Good emotional bonding",
      "score": 5
    },
    "nadi": {
      "boy": "Kapha",
      "girl": "Kapha",
      "dosha": "Nadi Dosha present",
      "severity": "High",
      "score": 0
    }
  }
}

{
  "remedies": {
    "nadiDosha": [
      {
        "remedy": "Nadi Nivaran Puja",
        "description": "Special puja to neutralize Nadi dosha effects",
        "when": "Before marriage",
        "cost": "Medium"
      },
      {
        "remedy": "Gemstone Therapy",
        "description": "Wear specific gemstones to balance energies",
        "stones": ["Pearl", "Red Coral"],
        "cost": "Low"
      }
    ],
    "manglikDosha": [
      {
        "remedy": "Manglik Dosha Nivaran Puja",
        "description": "Special ceremony to neutralize Manglik effects",
        "when": "Before marriage",
        "cost": "High"
      },
      {
        "remedy": "Kumbh Vivah Ceremony",
        "description": "Marriage ceremony with a clay pot",
        "when": "Before actual marriage",
        "cost": "Medium"
      }
    ],
    "general": [
      {
        "remedy": "Consult Professional Astrologer",
        "description": "Get personalized guidance from expert astrologer",
        "cost": "Variable"
      }
    ]
  },
  "timeline": {
    "immediate": ["Gemstone therapy"],
    "beforeMarriage": ["Nadi Nivaran Puja", "Manglik remedies"],
    "afterMarriage": ["Regular consultations"]
  }
}

Integration Examples

// Marriage compatibility checking
const compatibilityData = {
  boy: {
    date: '1995-06-15T14:30:00Z',
    latitude: 28.6139,
    longitude: 77.2090,
    timezone: 5.5,
    name: 'Rahul Sharma'
  },
  girl: {
    date: '1997-03-22T10:15:00Z',
    latitude: 27.7172,
    longitude: 85.3240,
    timezone: 5.75,
    name: 'Priya Thapa'
  },
  system: 'ashtakoot',
  includeRemedies: true,
  detailedReport: true
};

const response = await fetch('/v1/compatibility/match', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(compatibilityData)
});

const result = await response.json();

// Check overall compatibility
if (result.compatibility.percentage >= 75) {
  console.log('Excellent match! 🎉');
} else if (result.compatibility.percentage >= 60) {
  console.log('Good match with some considerations');
} else {
  console.log('Needs careful consideration and remedies');
}

// Check for doshas
if (result.ashtakoot.nadi.score === 0) {
  console.log('Nadi dosha present - remedies recommended');
}

if (result.manglik.girl.isManglik) {
  console.log('Girl has Manglik dosha - special ceremonies needed');
}

import requests

def check_marriage_compatibility(boy_details, girl_details):
    """
    Check marriage compatibility using Vedic astrology
    """
    compatibility_request = {
        "boy": boy_details,
        "girl": girl_details,
        "system": "ashtakoot",
        "includeRemedies": True,
        "detailedReport": True
    }

    headers = {'Authorization': 'Bearer YOUR_API_KEY'}
    response = requests.post(
        'https://api.astro-fusion.com/v1/compatibility/match',
        json=compatibility_request,
        headers=headers
    )

    return response.json()

# Example usage
boy = {
    'date': '1995-06-15T14:30:00Z',
    'latitude': 28.6139,  # Delhi
    'longitude': 77.2090,
    'timezone': 5.5,
    'name': 'Rahul Sharma'
}

girl = {
    'date': '1997-03-22T10:15:00Z',
    'latitude': 27.7172,  # Kathmandu
    'longitude': 85.3240,
    'timezone': 5.75,
    'name': 'Priya Thapa'
}

result = check_marriage_compatibility(boy, girl)

# Display results
print(f"Overall Compatibility: {result['compatibility']['percentage']}%")
print(f"Result: {result['compatibility']['result']}")

# Check individual koots
for koot_name, koot_data in result['ashtakoot'].items():
    status = koot_data['status']
    print(f"{koot_name.title()}: {status}")

# Show remedies if needed
if result['compatibility']['percentage'] < 80:
    print("\\nRecommended Remedies:")
    for category, remedies in result['remedies'].items():
        if remedies:
            print(f"\\n{category.replace('_', ' ').title()}:")
            for remedy in remedies:
                print(f"- {remedy['remedy']}: {remedy['description']}")

Understanding Compatibility Scores

90-100% - Excellent Match

Perfect harmony across all aspects. Marriage likely to be very successful with minimal challenges.

75-89% - Good Match

Strong compatibility with some areas needing attention. Marriage successful with minor remedies.

60-74% - Average Match

Moderate compatibility. Requires remedies and careful consideration before marriage.

50-59% - Below Average

Significant challenges expected. Strong remedies and professional consultation recommended.

Below 50% - Not Recommended

Serious compatibility issues. Marriage not advisable without extensive remedial measures.