Kundli Matching API

Calculate detailed Ashtakoot compatibility (Gun Milan) for kundli matching between two people. Returns accurate 36-point Guna Milan scale with breakdown across all 8 kootas (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi), Nadi and Bhakoot dosha detection with classical cancellation analysis per Muhurta Martanda and BPHS rules, and marriage recommendation. Perfect for kundli matching for marriage, matrimonial platforms, horoscope compatibility, and Vedic matchmaking services.

Request

POST /api/v2/vedic-astrology/compatibility

{
  "person1": {
    "date": "1990-07-04",
    "time": "10:12:00",
    "latitude": 28.6139,
    "longitude": 77.209,
    "timezone": 5.5
  },
  "person2": {
    "date": "1990-07-04",
    "time": "10:12:00",
    "latitude": 28.6139,
    "longitude": 77.209,
    "timezone": 5.5
  },
  "ayanamsa": "lahiri",
  "ayanamsaValue": 24
}

Response

Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.

{
  "frame": {
    "ayanamsa": "lahiri",
    "ayanamsaDegrees": 23.728208791839048
  },
  "total": 28,
  "maxScore": 36,
  "percentage": 77.77777777777779,
  "isCompatible": true,
  "recommendation": "Union is NOT recommended due to Nadi Dosha",
  "doshas": [
    "Nadi Dosha"
  ],
  "doshaCancellations": [],
  "breakdown": [
    {
      "category": "Varna",
      "maxScore": 1,
      "description": "Spiritual compatibility and mutual respect",
      "score": 1,
      "person1": "Brahmin",
      "person2": "Brahmin"
    },
    {
      "category": "Vashya",
      "maxScore": 2,
      "description": "Mutual control and dominance",
      "score": 2,
      "person1": "Keeta",
      "person2": "Keeta"
    },
    {
      "category": "Tara",
      "maxScore": 3,
      "description": "Birth star compatibility and luck",
      "score": 3,
      "person1": "Mitra",
      "person2": "Mitra"
    },
    {
      "category": "Yoni",
      "maxScore": 4,
      "description": "Sexual and physical compatibility",
      "score": 4,
      "person1": "Hare",
      "person2": "Hare"
    },
    {
      "category": "Graha Maitri",
      "maxScore": 5,
      "description": "Mental compatibility and affection",
      "score": 5,
      "person1": "Mars",
      "person2": "Mars"
    },
    {
      "category": "Gana",
      "maxScore": 6,
      "description": "Temperament and nature compatibility",
      "score": 6,
      "person1": "Deva",
      "person2": "Deva"
    },
    {
      "category": "Bhakoot",
      "maxScore": 7,
      "description": "Love, wealth, and family prosperity",
      "score": 7,
      "person1": "Scorpio",
      "person2": "Scorpio"
    },
    {
      "category": "Nadi",
      "maxScore": 8,
      "description": "Health, progeny, and genetic compatibility",
      "score": 0,
      "person1": "Madhya",
      "person2": "Madhya"
    }
  ]
}

Supported options

Call it in your language.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.vedicAstrology.calculateGunMilan({ body: { person1: { date: '1990-07-04', time: '10:12:00', latitude: 28.6139, longitude: 77.209, timezone: 5.5 }, person2: { date: '1990-07-04', time: '10:12:00', latitude: 28.6139, longitude: 77.209, timezone: 5.5 } } })

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.vedic_astrology.calculate_gun_milan(person1={'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209, 'timezone': 5.5}, person2={'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209, 'timezone': 5.5})

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->vedicAstrology->calculateGunMilan(person1: ['date' => '1990-07-04', 'time' => '10:12:00', 'latitude' => 28.6139, 'longitude' => 77.209, 'timezone' => 5.5], person2: ['date' => '1990-07-04', 'time' => '10:12:00', 'latitude' => 28.6139, 'longitude' => 77.209, 'timezone' => 5.5]);

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.VedicAstrology.Compatibility.PostAsync(new() { /* request fields above */ });

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.VedicAstrology.CalculateGunMilan(ctx, nil, roxyapi.CalculateGunMilanJSONRequestBody{ /* request fields above */ })

curl -X POST "https://roxyapi.com/api/v2/vedic-astrology/compatibility" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-07-04","time":"10:12:00","latitude":28.6139,"longitude":77.209,"timezone":5.5},"person2":{"date":"1990-07-04","time":"10:12:00","latitude":28.6139,"longitude":77.209,"timezone":5.5}}'

More Kundli Matching endpoints

The Kundli Matching API bundles these related endpoints under one key.

Remote MCP for AI agents

Every Vedic Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

claude mcp add --transport http \
  roxy-vedic-astrology https://roxyapi.com/mcp/vedic-astrology \
  --header "X-API-Key: YOUR_KEY"

Tool name for POST /vedic-astrology/compatibility: post_vedic_astrology_compatibility. Full MCP setup guide

What you can build

Drop-in UI components and no-code widgets.

Render Kundli Matching API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Kundli Matching API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

Guna milan widget snippetThe complete UI libraryExplore Roxy UI

Related capabilities

Kundli Matching API FAQ