Home › API Docs › Numerology API › Name Harmony

Name Harmony

POST /v1/numerology/name-harmony

**Name Harmony Analysis** Checks how well the name's numbers (Destiny, Soul Urge, Personality) harmonise with the birth numbers (Mulank, Bhagyank, Life Path) using the classical ideal-pair relationships. Returns a harmony score with per-pair detail — the analysis layer behind name-correction consultations. **Required:** dob, name **Optional:** system (chaldean|pythagorean, default chaldean) **Returns:** Harmony score (0-100), per-comparison detail, verdict, and bilingual interpretation.

Example request

curl -X POST https://api.grahaapi.com/v1/numerology/name-harmony   -H "Authorization: Bearer sk-test-your-key"   -H "Content-Type: application/json"   -d '{"dob":"1990-05-15","name":"Rahul Sharma","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.

Request fields

FieldTypeRequiredDescription
namestring✅Full name for numerology calculation
dobstring✅Date of birth in YYYY-MM-DD format
systemstring—Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western)

Example body

{
  "dob": "1990-05-15",
  "name": "Rahul Sharma",
  "system": "chaldean"
}

Get a free API key Try it in the playground

Related Numerology endpoints

/v1/numerology/bhagyank · /v1/numerology/bridge-number · /v1/numerology/business-compatibility · /v1/numerology/career · /v1/numerology/challenge-numbers · /v1/numerology/child