POST /v1/numerology/name-correction
**Name Correction & Spelling Suggestions** Analyses whether the current name's Destiny number harmonises with the Mulank and Bhagyank under 5 explicit classical rules, then suggests up to 10 pronunciation-safe corrected spellings (vowel softening and/or middle initials) that pass every rule. Useful for name-correction consultations in Vedic astrology apps. Optionally accepts father_name/mother_name — when given, the response adds a `family_sync` block: a first-letter frequency analysis of each parent's name against the person's own first letter, Mulank, and Bhagyank, with bilingual descriptions. Corroborative context only; it never changes which spellings pass. **Required:** dob, name **Optional:** system (chaldean|pythagorean, default chaldean), father_name, mother_name **Returns:** Current harmony verdict, up to 10 rule-checked spelling suggestions with ratings and mechanisms, and family_sync (null unless a parent name was given).
curl -X POST https://api.grahaapi.com/v1/numerology/name-correction -H "Authorization: Bearer sk-test-your-key" -H "Content-Type: application/json" -d '{"dob":"1990-05-15","father_name":"Suresh Sharma","mother_name":"Meena Sharma","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.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | Full name for numerology calculation |
dob | string | ✅ | Date of birth in YYYY-MM-DD format |
system | string | — | Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western) |
father_name | string | — | Optional — father's full name. When given, the response includes a family_sync block comparing his name's first-letter vibration against the person's own first letter, Mulank, and Bhagyank (same classical friend/enemy tables as the correction rules). Corroborative context only — never changes which spellings pass. |
mother_name | string | — | Optional — mother's full name. Same family_sync first-letter analysis as father_name. |
{
"dob": "1990-05-15",
"father_name": "Suresh Sharma",
"mother_name": "Meena Sharma",
"name": "Rahul Sharma",
"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