---
title: "Name Correction Analysis"
method: POST
path: "/v1/numerology/name-correction"
tags: ["Numerology"]
---

# Name Correction Analysis

`POST /v1/numerology/name-correction`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/name-correction`
- Auth: HTTP bearer

Analyses a full name using Pythagorean numerology and suggests spelling variants that are more harmonious with the life path number. Expression, Soul Urge and Personality are worked part by part, the same way as /v1/numerology/expression, /soul-urge and /personality. karmic_debt (and is_master) refer to the Expression number; expression_karmic_debt, soul_urge_karmic_debt and personality_karmic_debt give each number's karmic debt (13, 14, 16 or 19 anywhere in its reduction). Returns current name scores and up to 8 alternatives ranked by harmony.

## Request body

- NameCorrectionRequest
  - `name` string, required: Name to analyse (BirthInput `name`)
  - `date` string, date, required: Birth date YYYY-MM-DD (BirthInput `date`)

## Response `200`

Successful Response

- ApiResponseNameCorrectionResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` NameCorrectionResponse, required
    - `full_name` string, required
    - `birth_date` string, required
    - `life_path` integer, required
    - `current_name` NameCorrectionNameScore, required
      - `name` string, required
      - `expression` integer, required: Expression number: each name part reduced on its own (11, 22, 33 kept), then added and reduced — same as /v1/numerology/expression
      - `soul_urge` integer, required: Soul Urge (vowels), part by part — same as /v1/numerology/soul-urge
      - `personality` integer, required: Personality (consonants), part by part — same as /v1/numerology/personality
      - `is_master` boolean, required: True when the Expression number is 11, 22 or 33
      - `karmic_debt` integer, nullable: Karmic debt of the Expression number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none. Lowers harmony_score by 1
      - `expression_karmic_debt` integer, nullable: Karmic debt of the Expression number (same as karmic_debt): 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `soul_urge_karmic_debt` integer, nullable: Karmic debt of the Soul Urge number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `personality_karmic_debt` integer, nullable: Karmic debt of the Personality number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `compatibility` string, required
      - `harmony_score` integer, required
    - `alternatives` NameCorrectionNameScore[], required
      - `name` string, required
      - `expression` integer, required: Expression number: each name part reduced on its own (11, 22, 33 kept), then added and reduced — same as /v1/numerology/expression
      - `soul_urge` integer, required: Soul Urge (vowels), part by part — same as /v1/numerology/soul-urge
      - `personality` integer, required: Personality (consonants), part by part — same as /v1/numerology/personality
      - `is_master` boolean, required: True when the Expression number is 11, 22 or 33
      - `karmic_debt` integer, nullable: Karmic debt of the Expression number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none. Lowers harmony_score by 1
      - `expression_karmic_debt` integer, nullable: Karmic debt of the Expression number (same as karmic_debt): 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `soul_urge_karmic_debt` integer, nullable: Karmic debt of the Soul Urge number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `personality_karmic_debt` integer, nullable: Karmic debt of the Personality number: 13, 14, 16 or 19 met anywhere in the reduction of the total (e.g. 58 → 13 → 4 is 13); null when none
      - `compatibility` string, required
      - `harmony_score` integer, required
    - `recommendation` string, nullable

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)