TutorialMatrimony AppsJune 2026

Building a Kundali Matching Feature — Guna Milan API Guide for Matrimony Apps

Kundali matching is one of the most requested features in Indian matrimony and relationship apps. This guide covers every API endpoint you need — from the basic Guna Milan score to Rajju-Vedha compatibility check, Papasamaya dosha analysis, and bulk matching for showing compatibility with multiple candidates simultaneously.

What Kundali Matching Covers

Traditional Vedic kundali matching (Ashtakuta Milan) checks 8 compatibility factors based on the Moon sign and nakshatra of both individuals. Each factor has a maximum score — the total is 36 gunas. A score above 18 is considered compatible; above 28 is excellent.

Varna1 pointSpiritual compatibility
Vashya2 pointsMutual attraction
Tara3 pointsDestiny compatibility
Yoni4 pointsPhysical harmony
Graha Maitri5 pointsMental compatibility
Gana6 pointsNature compatibility
Bhakoot7 pointsLove and affection
Nadi8 pointsHealth and progeny

API Parameters for Matching Endpoints

All matching endpoints use a male/female prefix pattern. For north Indian style (most common), use /matching/north-match. For south Indian, use /matching/south-match:

# Male birth data: m_ prefix
# Female birth data: f_ prefix
curl "https://vedintelastroapi.com/api/v1/matching/north-match?
api_key=YOUR_KEY
&m_dob=15/08/1990&m_tob=08:30&m_lat=28.61&m_lon=77.20&m_tz=5.5
&f_dob=20/03/1992&f_tob=14:15&f_lat=19.07&f_lon=72.87&f_tz=5.5"
// Response
{
"status": 200,
"response": {
"total_points": 24.5,
"maximum_points": 36,
"compatibility_percentage": 68,
"compatibility_label": "Good",
"ashtakuta": { "varna": 1, "vashya": 2, ... }
}
}

Rajju-Vedha Compatibility Check

Rajju and Vedha are two additional compatibility checks that must pass regardless of the Guna Milan score. Rajju dosha in particular is considered a serious incompatibility that many families check before proceeding. Always run this in addition to the Guna Milan score:

GET /api/v1/matching/rajju-vedha-match?[same params]
// Response includes:
// rajju.compatible: true/false
// vedha.compatible: true/false
// rajju.male_rajju: "Sira" (head) / "Kantha" / "Udara" / "Kati" / "Paada"

Bulk Matching — Show Compatibility for Multiple Candidates

For a matrimony platform where you want to show a user their compatibility score with multiple candidates on a single page, the bulk endpoints compute multiple matches in one API call:

# /matching/bulk-north-match — use numbered suffix for each candidate
curl "https://vedintelastroapi.com/api/v1/matching/bulk-north-match?
api_key=KEY
&m1_dob=15/08/1990&m1_tob=08:30&m1_lat=28.61&m1_lon=77.20&m1_tz=5.5
&f1_dob=20/03/1992&f1_tob=14:15&f1_lat=19.07&f1_lon=72.87&f1_tz=5.5
&m2_dob=...&f2_dob=..."

Complete Matching Endpoint List

/matching/north-matchAshtakuta Guna Milan — North Indian style
/matching/south-matchAshtakuta Guna Milan — South Indian style
/matching/north-match-astro-detailsFull astro detail breakdown with north match
/matching/south-match-astro-detailsFull astro detail breakdown with south match
/matching/aggregate-matchCombined score across all matching systems
/matching/rajju-vedha-matchRajju and Vedha compatibility check
/matching/papasamaya-matchPapasamaya dosha comparison for both
/matching/nakshatra-matchNakshatra-level compatibility analysis
/matching/western-matchWestern astrology compatibility (synastry)
/matching/bulk-north-matchMultiple pairs in one call — north style
/matching/bulk-south-matchMultiple pairs in one call — south style

Add Kundali Matching to Your App Today

All 11 matching endpoints are available on the free plan. 500 calls/month, no credit card required. Upgrade to Starter for 100,000 calls/month — enough for a production matrimony platform.

Start Free →View PricingAPI Docs
Related articles
Integrating a Vedic astrology API in Next.js →How we verified 71 calculations against Jagannatha Hora →Kundali matching API — use case overview →