POST/v1/numerology/name-correction

Name Correction Analysis

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 parameters

namerequired

string

Name to analyse (BirthInput name)

daterequired

string (date)

Birth date YYYY-MM-DD (BirthInput date)

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.full_name

string

data.birth_date

string

data.life_path

integer

data.current_name

object

data.current_name.name

string

data.current_name.expression

integer

Expression number: each name part reduced on its own (11, 22, 33 kept), then added and reduced — same as /v1/numerology/expression

data.current_name.soul_urge

integer

Soul Urge (vowels), part by part — same as /v1/numerology/soul-urge

data.current_name.personality

integer

Personality (consonants), part by part — same as /v1/numerology/personality

data.current_name.is_master

boolean

True when the Expression number is 11, 22 or 33

data.current_name.karmic_debt

integer | null

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

data.current_name.expression_karmic_debt

integer | null

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

data.current_name.soul_urge_karmic_debt

integer | null

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

data.current_name.personality_karmic_debt

integer | null

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

data.current_name.compatibility

string

data.current_name.harmony_score

integer

data.alternatives

array[object]

data.alternatives[].name

string

data.alternatives[].expression

integer

Expression number: each name part reduced on its own (11, 22, 33 kept), then added and reduced — same as /v1/numerology/expression

data.alternatives[].soul_urge

integer

Soul Urge (vowels), part by part — same as /v1/numerology/soul-urge

data.alternatives[].personality

integer

Personality (consonants), part by part — same as /v1/numerology/personality

data.alternatives[].is_master

boolean

True when the Expression number is 11, 22 or 33

data.alternatives[].karmic_debt

integer | null

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

data.alternatives[].expression_karmic_debt

integer | null

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

data.alternatives[].soul_urge_karmic_debt

integer | null

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

data.alternatives[].personality_karmic_debt

integer | null

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

data.alternatives[].compatibility

string

data.alternatives[].harmony_score

integer

data.recommendation

string | null

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Generate lucky numbers
• Get number meaning by context
• Calculate numerology compatibility

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/numerology/name-correction" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta","date":"1985-11-12"}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.name_correction_request import NameCorrectionRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = NameCorrectionRequest(
    name="Arjun Mehta",
    date="1985-11-12",
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.name_correction(name_correction_request=request)
    print(result)

TypeScript

import { createClient, createConfig, nameCorrection } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await nameCorrection({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "full_name": "Arjun Mehta",
    "birth_date": "1985-11-12",
    "life_path": 1,
    "current_name": {
      "name": "Arjun Mehta",
      "expression": 3,
      "soul_urge": 1,
      "personality": 11,
      "is_master": false,
      "karmic_debt": null,
      "expression_karmic_debt": null,
      "soul_urge_karmic_debt": null,
      "personality_karmic_debt": null,
      "compatibility": "harmonious",
      "harmony_score": 4
    },
    "alternatives": [
      {
        "name": "Arjuni Mehta",
        "expression": 3,
        "soul_urge": 1,
        "personality": 11,
        "is_master": false,
        "karmic_debt": null,
        "expression_karmic_debt": null,
        "soul_urge_karmic_debt": null,
        "personality_karmic_debt": null,
        "compatibility": "harmonious",
        "harmony_score": 4
      },
      {
        "name": "Arjun Mehtai",
        "expression": 3,
        "soul_urge": 1,
        "personality": 11,
        "is_master": false,
        "karmic_debt": null,
        "expression_karmic_debt": null,
        "soul_urge_karmic_debt": null,
        "personality_karmic_debt": null,
        "compatibility": "harmonious",
        "harmony_score": 4
      },
      "... and 6 more items"
    ],
    "recommendation": null
  }
}