Use CaseKundli MilanAshtakootCompatibilityMarriage

Marriage Matching API
Kundli Milan. 7 Endpoints. North & South.

Complete Kundli Milan for matrimonial platforms — Ashtakoot (36-point), Dashakoot (South Indian), Rajju-Vedha, Papasamaya, and aggregate compatibility scores. Swiss Ephemeris precision.

Get Free API Key →API Documentation
Ashtakoot Kootas — What the API Returns
Varna1 pts
Spiritual compatibility
Vashya2 pts
Attraction & influence
Tara3 pts
Health & longevity
Yoni4 pts
Physical compatibility
Graha Maitri5 pts
Mental compatibility
Gana6 pts
Temperament match
Bhakoot7 pts
Financial prosperity
Nadi8 pts
Health & children
36 total points18+ acceptable · 24+ good · 32+ excellent

Matching Endpoints

GET /matching/north-match
Ashtakoot Gun Milan (North Indian style) — all 8 koota scores plus total points out of 36
Params: boy: dob/tob/lat/lon/tz, girl: dob/tob/lat/lon/tz
GET /matching/south-match
Dashakoot matching (South Indian/Tamil style) — 10 poruthams with pass/fail and score
Params: boy: dob/tob/lat/lon/tz, girl: dob/tob/lat/lon/tz
GET /matching/north-match-astro-details
Full astro details for both charts used in North Indian matching — nakshatras, padas, rashis, lords
Params: boy/girl birth data
GET /matching/south-match-astro-details
Full astro details for South Indian poruthams — nakshatra, rashi, janma rashi details
Params: boy/girl birth data
GET /matching/aggregate-match
Combined compatibility score across all kootas with recommendation and detailed analysis
Params: boy/girl birth data
GET /matching/rajju-vedha-match
Rajju and Vedha dosha check — critical compatibility factors in South Indian tradition
Params: boy/girl birth data
GET /matching/papasamaya-match
Papasamaya (malefic planet balance) compatibility check between two charts
Params: boy/girl birth data

Integration Example

kundli-match.js
// Ashtakoot Gun Milan — 36-point score
const matching = await fetch(
  'https://vedintelastroapi.com/api/v1/matching/north-match' +
  '?api_key=vai_YOUR_KEY' +
  // Boy's birth details
  '&m_dob=10/05/1992&m_tob=07:45&m_lat=19.0760&m_lon=72.8777&m_tz=5.5' +
  // Girl's birth details
  '&f_dob=22/08/1994&f_tob=11:30&f_lat=12.9716&f_lon=77.5946&f_tz=5.5'
).then(r => r.json())

// matching.response.total_points   → 28  (out of 36)
// matching.response.varna          → { points: 1, max: 1, compatible: true }
// matching.response.vashya         → { points: 2, max: 2, compatible: true }
// matching.response.tara           → { points: 3, max: 3, compatible: true }
// matching.response.yoni           → { points: 3, max: 4, compatible: true }
// matching.response.graha_maitri   → { points: 5, max: 5, compatible: true }
// matching.response.gana           → { points: 6, max: 6, compatible: true }
// matching.response.bhakoot        → { points: 7, max: 7, compatible: true }
// matching.response.nadi           → { points: 1, max: 8, compatible: false }
// matching.response.recommendation → "Good match — proceed with ceremony"

Marriage Matching API — FAQs

What is Ashtakoot Gun Milan and how is the score calculated?
Ashtakoot Gun Milan (also called Ashta Koota matching or Gun Milan) is the traditional Vedic marriage compatibility system used primarily in North India. It evaluates 8 factors (kootas): Varna (1 pt), Vashya (2 pts), Tara (3 pts), Yoni (4 pts), Graha Maitri (5 pts), Gana (6 pts), Bhakoot (7 pts), and Nadi (8 pts) — totalling 36 points. A score of 18+ is considered acceptable, 24+ is good, and 32+ is excellent. The API returns each individual koota score, max points, compatibility status, and a final recommendation.
What is the difference between North and South Indian matching?
North Indian (Ashtakoot) uses 8 factors and 36 total points, focused on nakshatra-based analysis. South Indian (Dashakoot or Porutham) uses 10 factors called Poruthams — Dina, Gana, Mahendra, Stree Deergha, Yoni, Rashi, Rajju, Vedha, Vasiya, Rajju — and is used predominantly in Tamil, Telugu, and Kannada communities. The API provides both systems so you can serve users across all regions of India.
What is Nadi dosha and how does the API handle it?
Nadi dosha occurs when both partners have the same Nadi (Aadi, Madhya, or Antya). It is considered the most serious of the 8 kootas because it is associated with health and progeny issues. The API returns the nadi for both persons, whether dosha exists, and notes any exceptions (Nadi dosha cancellation rules apply when certain other conditions are met). The API flags dosha presence without prescribing remedies — that is the astrologer's domain.
Can I match horoscopes for same-sex or non-traditional pairs?
The API accepts any two birth data sets as "person 1" and "person 2" regardless of gender. The parameters are m_ prefix (historically "male") and f_ prefix ("female") for compatibility with existing VedicAstroAPI integrations, but the computation works for any two charts. Results reflect the traditional Vedic framework — interpretation context is up to your platform.
What is Rajju-Vedha and why does it matter?
Rajju is a classification of nakshatras into 5 groups (Padha, Kantha, Nabhi, Kati, Siro Rajju) and Vedha is a list of nakshatra pairs that neutralise each other's positive effects. In South Indian tradition, Rajju-Vedha compatibility is often given as much weight as the overall Porutham score. The API returns whether Rajju dosha (same Rajju group) or Vedha (opposing nakshatras) exists between the two charts.
Related Use Cases
Kundli APIHoroscope APIDasha APIFree Vedic API Guide

Start for free. Ship today.

500 free API calls. No credit card. All 7 matching endpoints included.

Get Your Free API Key →