Kundli Match API

Overview

Kundli matching (Gun Milan) is essential for assessing marriage compatibility in Vedic astrology. This API provides:

Ashtakoota Milan: 8 compatibility factors totaling 36 points (Guna)
Manglik Analysis: Mars dosha check for both partners with cancellation rules
Nadi Dosha: Health and progeny compatibility check
Bhakoot Dosha: Moon sign relationship analysis
Rajju Dosha: Longevity and protection factor
Detailed Recommendations: Remedies and compatibility summary

Important: A score of 18+ out of 36 is generally considered acceptable. However, certain doshas like Nadi and Bhakoot require careful analysis even with high scores.

Request

cURL

curl -X POST "https://api.vedika.io/v2/astrology/kundli-match" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "bride": {
      "datetime": "1995-08-20T14:30:00+05:30",
      "latitude": 28.6139,
      "longitude": 77.2090,
      "name": "Priya"
    },
    "groom": {
      "datetime": "1992-03-15T08:45:00+05:30",
      "latitude": 19.0760,
      "longitude": 72.8777,
      "name": "Rahul"
    }
  }'

JavaScript

const response = await fetch('https://api.vedika.io/v2/astrology/kundli-match', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    bride: {
      datetime: '1995-08-20T14:30:00+05:30',
      latitude: 28.6139,
      longitude: 77.2090,
      name: 'Priya'
    },
    groom: {
      datetime: '1992-03-15T08:45:00+05:30',
      latitude: 19.0760,
      longitude: 72.8777,
      name: 'Rahul'
    }
  })
});

const data = await response.json();

Python

import requests

response = requests.post(
    'https://api.vedika.io/v2/astrology/kundli-match',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'bride': {
            'datetime': '1995-08-20T14:30:00+05:30',
            'latitude': 28.6139,
            'longitude': 77.2090,
            'name': 'Priya'
        },
        'groom': {
            'datetime': '1992-03-15T08:45:00+05:30',
            'latitude': 19.0760,
            'longitude': 72.8777,
            'name': 'Rahul'
        }
    }
)

data = response.json()

Parameters

Parameter	Type	Required	Description
`bride`	object	Required	Bride's birth details object
`bride.datetime`	string	Required	Birth date/time in ISO 8601 format
`bride.latitude`	number	Required	Birth location latitude
`bride.longitude`	number	Required	Birth location longitude
`bride.name`	string	Optional	Bride's name for report
`groom`	object	Required	Groom's birth details (same structure as bride)
`ayanamsa`	string	Optional	Ayanamsa system (default: "lahiri")

Response

{
  "success": true,
  "data": {
    "bride": {
      "name": "Priya",
      "moonSign": "Virgo",
      "nakshatra": "Hasta",
      "nakshatraPada": 3,
      "nadi": "Madhya",
      "gana": "Deva",
      "yoni": "Buffalo",
      "vashya": "Manav",
      "isManglik": false
    },
    "groom": {
      "name": "Rahul",
      "moonSign": "Taurus",
      "nakshatra": "Rohini",
      "nakshatraPada": 2,
      "nadi": "Antya",
      "gana": "Manushya",
      "yoni": "Serpent",
      "vashya": "Chatushpad",
      "isManglik": true,
      "manglikCancelled": true,
      "manglikCancellationReason": "Mars in own sign"
    },
    "ashtakoota": {
      "totalScore": 26,
      "maxScore": 36,
      "percentage": 72.2,
      "koota": [
        {
          "name": "Varna",
          "description": "Spiritual compatibility",
          "obtained": 1,
          "maximum": 1,
          "brideVarna": "Vaishya",
          "groomVarna": "Vaishya"
        },
        {
          "name": "Vashya",
          "description": "Mutual attraction & control",
          "obtained": 2,
          "maximum": 2,
          "analysis": "Good mutual understanding"
        },
        {
          "name": "Tara",
          "description": "Birth star compatibility",
          "obtained": 3,
          "maximum": 3,
          "starCount": 7,
          "analysis": "Favorable Kshema tara"
        },
        {
          "name": "Yoni",
          "description": "Physical & sexual compatibility",
          "obtained": 2,
          "maximum": 4,
          "brideYoni": "Buffalo",
          "groomYoni": "Serpent",
          "analysis": "Neutral - some adjustments needed"
        },
        {
          "name": "Graha Maitri",
          "description": "Mental compatibility",
          "obtained": 5,
          "maximum": 5,
          "brideLord": "Mercury",
          "groomLord": "Venus",
          "analysis": "Excellent mental harmony"
        },
        {
          "name": "Gana",
          "description": "Temperament compatibility",
          "obtained": 5,
          "maximum": 6,
          "brideGana": "Deva",
          "groomGana": "Manushya",
          "analysis": "Good - Divine and Human compatible"
        },
        {
          "name": "Bhakoot",
          "description": "Relative moon positions",
          "obtained": 7,
          "maximum": 7,
          "relationship": "5-9",
          "analysis": "Highly auspicious - promotes prosperity",
          "hasDosha": false
        },
        {
          "name": "Nadi",
          "description": "Health & genetic compatibility",
          "obtained": 8,
          "maximum": 8,
          "brideNadi": "Madhya",
          "groomNadi": "Antya",
          "analysis": "Different nadis - excellent for progeny",
          "hasDosha": false
        }
      ]
    },
    "doshaAnalysis": {
      "manglikDosha": {
        "brideHas": false,
        "groomHas": true,
        "groomCancelled": true,
        "compatible": true,
        "recommendation": "Manglik dosha cancelled due to Mars placement. No remedies needed."
      },
      "nadiDosha": {
        "present": false,
        "severity": null,
        "recommendation": "No Nadi dosha - excellent for health and children"
      },
      "bhakootDosha": {
        "present": false,
        "recommendation": "5-9 relationship is highly auspicious"
      },
      "rajjuDosha": {
        "present": false,
        "type": null,
        "recommendation": "No Rajju dosha - promotes longevity"
      }
    },
    "summary": {
      "overallScore": 26,
      "rating": "Good",
      "compatibility": "high",
      "recommendation": "This match is favorable with 72% compatibility. The Gana and Yoni scores suggest some temperament differences that can be managed with understanding. Strong Bhakoot and Nadi scores indicate prosperity and healthy progeny.",
      "strengths": [
        "Excellent mental compatibility (Graha Maitri)",
        "No Nadi dosha",
        "Auspicious 5-9 Bhakoot relationship",
        "Manglik dosha naturally cancelled"
      ],
      "concerns": [
        "Moderate Yoni compatibility - physical adjustments needed",
        "Gana difference requires patience"
      ],
      "remedies": [
        "Perform Ganapati Homam before marriage",
        "Bride can donate green items on Wednesdays"
      ]
    }
  },
  "metadata": {
    "requestId": "req_match_xyz789",
    "calculatedAt": "2026-01-07T12:00:00Z",
    "ayanamsaUsed": "lahiri",
    "cost": 0.008
  }
}

Ashtakoota Guide

Koota	Points	Significance
Varna	1	Spiritual/ego compatibility
Vashya	2	Mutual attraction & influence
Tara	3	Destiny & fortune together
Yoni	4	Physical & intimate compatibility
Graha Maitri	5	Mental wavelength
Gana	6	Nature & temperament
Bhakoot	7	Emotional bonding & prosperity
Nadi	8	Health & progeny

25-36 Points

Excellent Match

18-24 Points

Good Match

<18 Points

Not Recommended

Related Endpoints

POST /mangal-dosha

Detailed Manglik analysis

POST /guna-milan

Quick Guna matching

POST /nadi-dosha

Nadi dosha check