Matchmaking API

Ashtkoot Guna Milan

Automate Vedic matchmaking with precise 36-point Ashtkoot calculations. Evaluate Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi with advanced dosha cancellation checks.

Start Free Trial View Documentation
POST /v1/matching/ashtkoot 
{
  "total_score": 28.5,
  "maximum_score": 36,
  "is_compatible": true,
  "nadi_dosha": {
    "is_present": false,
    "cancellation_reason": "Same Nakshatra, different Pada exception."
  },
  "breakdown": {
    "bhakoot": { "score": 7, "max": 7 },
    "nadi": { "score": 8, "max": 8 }
  }
}

Advanced Matchmaking Infrastructure

Powering modern matrimonial apps with enterprise-grade astrological logic.

Deep Dosha Cancellations

Don't falsely reject matches. Our engine checks for Parihara (cancellations) for Nadi, Bhakoot, and Manglik Dosha based on Pada, Nakshatra, and planetary lords.

North & South Systems

Toggle between the 36-point North Indian Ashtkoot system and the 10-point South Indian Dashkoot (Porutham) system with a single API parameter.

High-Volume Processing

Process thousands of matches per second. Ideal for matrimonial platforms running batch compatibility checks across large user databases.

Simple Request, Comprehensive Response

Send the birth details of both individuals and get an instantly parsed compatibility report.

Required Parameters

  • partner_1: date (YYYY-MM-DD), time (HH:MM), lat, lon, tzone
  • partner_2: date (YYYY-MM-DD), time (HH:MM), lat, lon, tzone
  • system: ashtkoot (default) or dashkoot
  • lang: en (default), hi, or ta
Read Full API Reference

Frequently Asked Questions

Technical details regarding the Ashtkoot Marital Matching API.

Does the API handle Nadi and Bhakoot Dosha cancellations (Parihara)?
Yes, this is our most advanced feature. The API doesn't just calculate a 0 for Nadi Dosha; it runs a deep check for exceptions. If the couple shares the same Nakshatra but different Padas, or the same sign but different Nakshatras, the dosha is canceled and the API returns full points.
Do you support Manglik (Kuja) Dosha compatibility checks?
Yes, the matchmaking endpoint automatically cross-references Manglik Dosha between both charts. If one partner is Manglik and the other is not, the API checks for astrological nullifications (like Saturn's placement) to determine overall martial compatibility.
Can I generate South Indian Dashkoot (10-point) matching?
Yes. While Ashtkoot (36-points) is the default standard for North India, you can pass "system": "dashkoot" in your JSON payload to return the South Indian matching system, which includes Mahendra, Stree-Deergha, and Rajju Porutham.
What data do I need to send in the request?
You need to POST a JSON array containing the exact birth date, time, latitude, longitude, and timezone offset for both the boy and the girl. The API instantly processes both charts and returns the comparative data.
Does the response include text recommendations for the couple?
Yes, the API provides a concluding 'conclusion' string that explains the compatibility result in natural language, available in both English and Hindi via the lang parameter.
How is Gana Maitri calculated?
The API automatically classifies both partners into Deva, Manushya, or Rakshasa Gana based on their birth Nakshatra and computes the compatibility score according to traditional Vedic texts.
Can we get individual point scores for all 8 koots?
Yes. The JSON response includes a detailed breakdown object showing the exact points scored versus maximum possible points for Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi.
Does the engine check for Rajju Dosha?
Yes, when utilizing the Dashkoot or advanced Ashtkoot parameters, the API calculates Rajju Dosha (Sirsu, Kanth, Nabhi, Kati, Pada) and flags critical matches.
Are same-sex charts supported for matching?
Yes, the underlying astronomical algorithm processes the planetary and Nakshatra placements of any two charts provided, regardless of gender inputs.
Does it analyze the Navamsha (D9) chart for marriage?
Yes. By appending the include_d9_check=true parameter, the engine will cross-evaluate the 7th house and Venus placements in both individuals' Navamsha charts for a deeper psychological compatibility score.