Numerology Gun Milan

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.

Example request

cURL
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 input. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi name twins where available (e.g. sign / sign_hi).

Request fields

FieldTypeRequiredDescription
person1_dobstringrequiredPerson 1 date of birth YYYY-MM-DD
person1_namestringoptionalPerson 1 full name (optional, for name number)
person1_genderstringrequired'male' or 'female'
person2_dobstringrequiredPerson 2 date of birth YYYY-MM-DD
person2_namestringoptionalPerson 2 full name (optional)
person2_genderstringrequired'male' or 'female'
systemstringoptionalNumerology system

Example body

JSON
{
  "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"
}