# Name correction (Chaldean and Cheiro)

`POST https://api.astroway.info/v1/numerology/name-correction`

The name number under two conventions, Chaldean as practised in India (one letter total, planets with Rahu and Ketu, BPHS planetary friendship) and Cheiro (each name reduced, the singles added into the compound, his harmony groups), its compatibility with the driver and conductor, and candidate spellings one change away (double a letter, add a silent E or an H, drop a silent letter) that land on a favourable number with a compound Cheiro does not read as unfavourable. Deterministic, no AI. 20 credits: it rescores every candidate.

Group: Numerology: Indian. Auth: `X-Api-Key` header. Operation ID: `numerology_name-correction`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `fields` | query | no | string | Comma-separated dotted paths, relative to `data`, to keep in the response. A path is applied to every element of an array, so `planets.name` means the name of each planet. Paths that match nothing come back in `_fields_unmatched`; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer. |
| `precision` | query | no | integer | Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute. |
| `Idempotency-Key` | header | no | string | Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with `Idempotent-Replayed: true` and costs 0 credits. The same key with a different body or query string is a 409 `IDEMPOTENCY_KEY_REUSED`; a repeat while the first is still running is a 409 `IDEMPOTENCY_IN_PROGRESS`. Only 2xx responses are kept. See /idempotency/. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes | The name as it is used, in Latin letters. |
| `date` | string | yes |  |
| `convention` | "chaldean" \| "cheiro" | no | Which convention picks the candidates. Default chaldean. The current name is read under both. |
| `limit` | integer | no | Most candidates to return. Default 10. |

```json
{
  "name": "Sunil Verma",
  "date": "1995-11-23",
  "limit": 3
}
```

## Responses

| Status | Meaning |
|---|---|
| 200 | Successful calculation |
| 400 | Validation error |
| 401 | Missing or invalid API key |

### Success fields, under `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string | no |  |
| `date` | string | no |  |
| `driver` | object | no |  |
| `driver.number` | number | no |  |
| `driver.planet` | string | no |  |
| `conductor` | object | no |  |
| `conductor.number` | number | no |  |
| `conductor.planet` | string | no |  |
| `current` | object | no |  |
| `current.chaldean` | object | no |  |
| `current.cheiro` | object | no |  |
| `convention` | string | no |  |
| `favourableNumbers` | number[] | no |  |
| `candidates` | object[] | no |  |
| `searched` | number | no |  |
| `rule` | string | no |  |
| `conventions` | object | no |  |
| `conventions.chaldean` | string | no |  |
| `notes` | string[] | no |  |

## Example

```bash
curl -X POST https://api.astroway.info/v1/numerology/name-correction \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Sunil Verma", "date": "1995-11-23", "limit": 3 }'
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/numerology_name-correction/