Skip to content
Compatibility & Gun Milan API

Ashtakoot, porutham, and marriage matching APIs

Ship matchmaking flows with deterministic scoring and structured compatibility payloads — the same engines behind production matrimony features.

Gun Milan APIs for matrimony and dating products

North Indian matchmaking flows center on Ashtakoot — eight kootas scored out of 36 points — plus Manglik dosha checks and increasingly Nakshatra-level compatibility summaries. Building this in-house means computing two sidereal charts, applying house rules, and maintaining scoring tables that vary by regional interpretation.

Navamsha returns structured koota breakdowns so your UI can show transparent scoring — not just a single number — which builds trust with families comparing horoscopes online. Porutham endpoints cover South Indian ten-koota matching for products serving Tamil, Telugu, and Malayalam audiences.

Batch screening and interactive UX

Matrimony SaaS platforms call Ashtakoot when a user views a profile, caching scores by sorted pair hash to avoid recomputation on every page load. Dating apps may offer compatibility as a premium upsell — pairwise POST endpoints fit interactive flows where latency under a second matters.

Manglik status is often surfaced before detailed Gun Milan — a lightweight GET on /api/v1/dosha/manglik flags Mars placements from classical house rules. Document your product's threshold (commonly 18/36 minimum, 24+ favorable) in UX copy; the API returns raw scores for flexible policy.

Regional conventions and support

Gun Milan is not one universal algorithm in the wild — pandits may apply cancellations and exceptions Navamsha documents in Swagger but your product must set expectations. Always use the same Lahiri charts for both partners in a request; mixed ayanamsa inputs are a common source of score disputes when migrating from legacy vendors.

The compatibility family shares authentication and billing with Kundali and Panchang routes — one API key, unified metering, and OpenAPI discovery for agent tooling. Start integration on the free tier at www.navamsha.in/auth/signup and validate outputs against profiles you already trust.

Example endpoints

POST/api/v1/matchmaking/ashtakoot

36-point Ashtakoot score

2 credit / call
GET/api/v1/dosha/manglik

Manglik dosha check

1 credit / call
POST/api/v1/matchmaking/porutham

South Indian porutham

2 credit / call

What you can build

Matrimony SaaS platforms

Score candidate pairs in batch during profile browsing. Return structured koota breakdowns for transparent UX.

Dating app compatibility layers

Add optional Vedic compatibility as a premium feature without building ephemeris infrastructure in-house.

Family matchmaking portals

Combine Gun Milan score, Manglik status, and Nakshatra matching in a single API workflow for pandit-assisted flows.

How it works

  1. 1

    Submit birth details for both partners — Navamsha computes sidereal charts for each using Lahiri ayanamsa.

  2. 2

    Eight Ashtakoot factors (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi) are scored out of 36 points.

  3. 3

    Manglik dosha is evaluated separately via Mars house placement rules for both charts.

  4. 4

    Porutham endpoint covers South Indian ten-koota matching for regional matrimony products.

Sample request / response

Request

curl -X POST "https://api.navamsha.in/api/v1/matchmaking/ashtakoot" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bride": { "year": 1995, "month": 8, "date": 15, "hours": 14, "minutes": 30,
      "latitude": 19.0760, "longitude": 72.8777, "timezone": 5.5 },
    "groom": { "year": 1993, "month": 3, "date": 22, "hours": 9, "minutes": 15,
      "latitude": 28.6139, "longitude": 77.2090, "timezone": 5.5 }
  }'

Response (abbreviated)

{
  "total_score": 28,
  "max_score": 36,
  "kootas": {
    "varna": { "score": 1, "max": 1 },
    "vashya": { "score": 2, "max": 2 },
    "tara": { "score": 3, "max": 3 },
    "yoni": { "score": 4, "max": 4 }
  },
  "recommendation": "Good match",
  "metadata": { "ayanamsa": "lahiri", "system": "ashtakoot" }
}

Built for

    Matrimony SaaS

    Dating compatibility layers

    Family matchmaking portals

FAQ

What is the Gun Milan API used for?

36-point Ashtakoot scoring, porutham, papasamyam, and Manglik checks for matrimony platforms, dating apps, and family matchmaking workflows.

What ayanamsa does Navamsha use?

Lahiri ayanamsa for both charts in a compatibility request, ensuring consistent sidereal positions for Gun Milan scoring.

Is there a free tier?

Yes — integrate matchmaking during launch with 10,000 free monthly calls. Ashtakoot endpoints typically cost 2 credits per pair.

How fast are compatibility API responses?

Matchmaking calls compute two charts plus scoring — still tuned for interactive UX in matrimony flows and batch screening tools.

What is a passing Gun Milan score?

Traditionally 18/36 is minimum; 24+ is considered good. Your product can set thresholds — the API returns raw koota scores for flexible UX.

Does the API handle Manglik cancellation?

Manglik endpoint returns dosha status and common cancellation rules. Verify exact rule set in Swagger against your pandit's reference.

Can I match more than two people?

Ashtakoot is a pairwise endpoint. For batch screening, call it per candidate pair — rate limits apply per your tier.