New Numerology API

Name and number checks

Name correction in numerology

Name correction means changing the spelling of a name so its number suits the person better. The new spelling keeps the name sounding the same, such as aa for a or ee for i. The API tries at most two such changes and never ranks the results. A new spelling changes the name's number, not the person.

Updated

More terms in Name and number checks

© API for Astrology (apiforastrology.com). "Name correction explained". All rights reserved. Not to be copied or reused.Name correction: a spelling that fitsNameMobileVehicleHouseBusinessLaunchJohn Doe's name and a spelling that fits him (Chaldean)John Doe347NeutralJohn Dow358Good fitThe same sound, a different number

Name correction: how the API works it out

POST /v1/name/suggest tries small spelling changes on one word of the name. The part field picks the word, and 0, the first name, is the default. It only tries changes that keep the name sounding the same.

These are a and aa, i and ee, u and oo, ph and f, and v and w. A v or w is never changed as the first letter. The API can also double the last consonant, or add a silent h after a final a.

At most two changes are combined. Some changes are left out on purpose, because each one makes a different name. The API never doubles an e or an o.

It never shortens ee to e or oo to o, and it never adds a final a. A spelling is suggested only when its Chaldean number is in targets. By default, targets holds every number whose fit with the person is good.

Results come in a fixed order, fewer changes first, then A to Z. They are never ranked, and ranked is false. Each one lists its changes.

The found field counts every match before limit, and none holds a sentence when nothing matches. That is the case for John Doe, whose spelling can stay as it is. To compare spellings you already have, send up to 10 in variants to POST /v1/name.

The suggest answer also carries not_claimed_spelling: a new spelling changes the number of the name, not the person.

The Chaldean letter values, with no letter worth 9, follow the table in Cheiro's Book of Numbers (1926).

Get it from the API

Name spelling suggestions. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990.

POST /v1/name/suggest

# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/name/suggest" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe","birth_date":"1990-08-15"}'
Answer (long lists shortened)200 OK
{
  "name": "John Doe",
  "part": 0,
  "word": "John",
  "current": {
    "total": 34,
    "compound": 34,
    "number": 7,
    "planet": "Ketu",
    "planet_name": "Ketu",
    "fit": {
      "number": 7,
      "links": [
        {
          "from": "mulank",
          "from_number": 6,
          "to_number": 7,
          "relation": "neutral",
          "via": [
            "Ketu"
          ],
          "from_name": "mulank",
          "relation_name": "neutral"
        },
        {
          "from": "bhagyank",
          "from_number": 6,
          "to_number": 7,
          "relation": "neutral",
          "via": [
            "Ketu"
          ],
          "from_name": "bhagyank",
          "relation_name": "neutral"
        }
      ],
      "outcome": "neutral",
      "outcome_name": "Neutral",
      "reading": "This number is neutral to your own numbers. It neither helps nor gets in the way much."
    }
  },
  "targets": [
    4,
    5
  ],
  "tried": 1,
  "found": 0,
  "suggestions": [],
  "person": {
    "birth_date": "1990-08-15",
    "mulank": 6,
    "bhagyank": 6
  },
  "system": "chaldean",
  "about": "These spellings sound the same as your name but add up to a number that suits you. Only small, common spelling changes are tried.",
  "none": "No small spelling change gives a number that suits you. Your current spelling can stay as it is.",
  "ranked": false,
  "not_claimed_spelling": "A new spelling changes the number of the name, not the person. Choose one only if you are happy to use it every day.",
  "not_claimed": "Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.",
  "localization": {
    "lang": "en",
    "detail": "standard",
    "fell_back_to_en": [],
    "fell_back_to_standard": []
  }
}

Where the API returns it

POST/v1/name/suggestName spelling suggestions
POST/v1/nameName checker
POST/v1/businessBusiness name and launch date

Feature page: Name checker. The rules the API follows are on the conventions page.

Related terms

From the blog

Numerology API

Get these numbers from the API

Create a free test key and call any route on this page with the sample people. Or try a request in the API reference first.

Your first answer

John Doe, born Aug 15, 1990

POST /v1/profile200 OK
  • Mulank6Venus
  • Bhagyank6Destiny number
  • Name number7Ketu

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    One key: the same key, plan and reading credits as the Astrology API