POST /v1/numerology/gun-milan
**Numerology Gun Milan (8-Koot Compatibility)** Computes Vedic-style Ashtakoot (8-koot) marriage compatibility between two people using their numerology numbers — Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi — out of 36 points, with Nadi-dosha detection and remedies. **Required:** person1_dob, person1_gender, person2_dob, person2_gender **Optional:** person1_name, person2_name, system **Returns:** All 8 koots (score/max/desc), total score, percentage, compatibility level, dosha flags, strengths, challenges, remedies, and a bilingual interpretation.
curl -X POST https://api.grahaapi.com/v1/numerology/gun-milan -H "Authorization: Bearer sk-test-your-key" -H "Content-Type: application/json" -d '{"person1_dob":"1990-05-15","person1_gender":"male","person1_name":"Rahul Sharma","person2_dob":"1993-08-22","person2_gender":"female","person2_name":"Priya Singh","system":"chaldean"}'Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.
| Field | Type | Required | Description |
|---|---|---|---|
person1_dob | string | ✅ | Person 1 date of birth YYYY-MM-DD |
person1_name | string | — | Person 1 full name (optional, for name number) |
person1_gender | string | ✅ | 'male' or 'female' |
person2_dob | string | ✅ | Person 2 date of birth YYYY-MM-DD |
person2_name | string | — | Person 2 full name (optional) |
person2_gender | string | ✅ | 'male' or 'female' |
system | string | — | Numerology system |
{
"person1_dob": "1990-05-15",
"person1_gender": "male",
"person1_name": "Rahul Sharma",
"person2_dob": "1993-08-22",
"person2_gender": "female",
"person2_name": "Priya Singh",
"system": "chaldean"
}Get a free API key Try it in the playground
/v1/numerology/bhagyank · /v1/numerology/bridge-number · /v1/numerology/business-compatibility · /v1/numerology/career · /v1/numerology/challenge-numbers · /v1/numerology/child