Match by Birth Details

POST/api/v1/vedic/match

The easiest way to check Vedic compatibility. Simply provide birth details for two people, and we calculate their Moon positions and Ashtakoota score automatically.

Full URL

https://astro-api-1qnc.onrender.com/api/v1/vedic/match

Ashtakoota (8 Kootas) Scoring

Total possible score: 36 points. 18+ is generally considered acceptable for marriage.

Nadi

Health & genes

Bhakoot

Emotional bond

Gana

Temperament

Graha Maitri

Friendship

Yoni

Intimacy

Tara

Destiny

Vashya

Attraction

Varna

Spiritual

Request Parameters

Parameter	Type	Required	Description
p1.year	integer	Yes	Person 1: Year of birth
p1.month	integer	Yes	Person 1: Month of birth (1-12)
p1.day	integer	Yes	Person 1: Day of birth
p1.hour	integer	Yes	Person 1: Hour of birth (0-23)
p1.minute	integer	Yes	Person 1: Minute of birth
p1.lat	float	Yes	Person 1: Latitude
p1.lng	float	Yes	Person 1: Longitude
p1.city	string	No	Person 1: City name
p1.tz_str	string	No	Person 1: Timezone
p2.*	same as p1	Yes	Person 2: Same fields as Person 1

Sample Code

import requests
import json

url = "https://astro-api-1qnc.onrender.com/api/v1/vedic/match"

payload = {
    "p1": {
        "year": 1990,
        "month": 5,
        "day": 15,
        "hour": 10,
        "minute": 30,
        "lat": 28.6139,
        "lng": 77.2090,
        "city": "New Delhi",
        "tz_str": "Asia/Kolkata"
    },
    "p2": {
        "year": 1993,
        "month": 8,
        "day": 21,
        "hour": 14,
        "minute": 0,
        "lat": 28.6139,
        "lng": 77.2090,
        "city": "New Delhi",
        "tz_str": "Asia/Kolkata"
    }
}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response Data

{
  "total_score": 24.5,
  "max_score": 36.0,
  "percentage": 68.1,
  "recommendation": "Average Match",
  "interpretation": "A moderately compatible match. Some adjustments may be needed in certain areas.",
  
  "p1_details": {
    "moon_sign": "Capricorn",
    "moon_sign_num": 10,
    "moon_nakshatra": {
      "id": 22,
      "name": "Shravana",
      "lord": "Moon",
      "pada": 2
    },
    "moon_degree": 14.234
  },
  
  "p2_details": {
    "moon_sign": "Virgo",
    "moon_sign_num": 6,
    "moon_nakshatra": {
      "id": 13,
      "name": "Hasta",
      "lord": "Moon",
      "pada": 3
    },
    "moon_degree": 8.567
  },
  
  "scores": {
    "varna": {
      "score": 1.0,
      "max": 1.0,
      "description": "Spiritual compatibility - caste/temperament match"
    },
    "vashya": {
      "score": 1.5,
      "max": 2.0,
      "description": "Mutual attraction and control"
    },
    "tara": {
      "score": 2.0,
      "max": 3.0,
      "description": "Birth star compatibility and destiny"
    },
    "yoni": {
      "score": 3.0,
      "max": 4.0,
      "description": "Physical and sexual compatibility"
    },
    "graha_maitri": {
      "score": 4.0,
      "max": 5.0,
      "description": "Mental and intellectual compatibility"
    },
    "gana": {
      "score": 5.0,
      "max": 6.0,
      "description": "Temperament match (Deva/Manushya/Rakshasa)"
    },
    "bhakoot": {
      "score": 0.0,
      "max": 7.0,
      "description": "Emotional and family life compatibility"
    },
    "nadi": {
      "score": 8.0,
      "max": 8.0,
      "description": "Health and genetic compatibility"
    }
  },
  
  "doshas": {
    "nadi_dosha": false,
    "bhakoot_dosha": true,
    "manglik_match": {
      "p1_manglik": false,
      "p2_manglik": false,
      "compatible": true
    }
  },
  
  "metadata": {
    "ayanamsha": "lahiri"
  }
}

Related Endpoints

Manual Compatibility

If you already have Moon Nakshatra IDs

Basic Chart

Get individual Moon positions