Names

Name Numerology API: Check Spellings Against a Person's Numbers

The name numerology API from API for Astrology (apiforastrology.com) finds a name's number and how it suits a person. It reads that number against the person's mulank (birth day number) and bhagyank (destiny number). Check up to 10 other spellings in one call, or ask for sound-alike spellings that fit better. A check costs 1 reading credit.

Get a free API key Try it in the API reference

Updated Nov 7, 2026

How the name numerology API works

1Send the name in English letters, the birth date and up to 10 other spellings.
2Each spelling is added up in Chaldean, and its number is read against the person's two numbers.
3John Doe adds up to 7, a neutral fit for him, while Jon Doe is not a good fit.

POST /v1/name200 OK

{
  "spellings": [
    {
      "name": "John Doe",
      "chaldean": {
        "number": 7
      },
      "fit": {
        "outcome": "neutral"
      }
    },
    {
      "name": "Jon Doe",
      "chaldean": {
        "number": 2
      },
      "fit": {
        "outcome": "difficult"
      }
    },
    {
      "name": "John Dow",
      "chaldean": {
        "number": 8
      },
      "fit": {
        "outcome": "good"
      }
    }
  ],
  "ranked": false
}

John Doe's name and two other spellings, each with its Chaldean number and how well it fits his numbers. Real output for John Doe, born Aug 15, 1990, with two other spellings.

How three spellings of John Doe compare

This is the real answer for John Doe, born August 15, 1990, with two other spellings. His mulank and bhagyank are both 6 (Venus). Each spelling is added up in Chaldean letter values.

How three spellings of John Doe compare
Spelling	How it adds up	Number and fit
John Doe	John 18 + Doe 16 = 34, then 3 + 4 = 7	7, Ketu: neutral
Jon Doe	Jon 13 + Doe 16 = 29, then 2 + 9 = 11, then 1 + 1 = 2	2, Moon: difficult
John Dow	John 18 + Dow 17 = 35, then 3 + 5 = 8	8, Saturn: good

Every answer ends with the same caution in its not_claimed field: “Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.”

Check a name with the free name numerology calculator

Call the name numerology API from your code

Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it. The same key works for the Astrology API.

POST /v1/name

# John Doe, born Aug 15, 1990, with two other spellings
curl -X POST "https://apiforastrology.com/api/numerology/v1/name" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe","birth_date":"1990-08-15","variants":["Jon Doe","John Dow"]}'

Response (lists shortened)200 OK

{
  "person": {
    "birth_date": "1990-08-15",
    "mulank": 6,
    "bhagyank": 6
  },
  "system": "chaldean",
  "about": "A name is read from its letters.",
  "spellings": [
    {
      "name": "John Doe",
      "chaldean": {
        "total": 34,
        "compound": 34,
        "number": 7,
        "master": false,
        "words": [
          {
            "word": "John",
            "total": 18,
            "number": 9
          },
          {
            "word": "Doe",
            "total": 16,
            "number": 7
          }
        ]
      },
      "pythagorean": {
        "total": 35,
        "number": 8,
        "master": false
      },
      "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."
      }
    },
    {
      "name": "Jon Doe",
      "chaldean": {
        "total": 29,
        "compound": 29,
        "number": 2,
        "master": true,
        "words": [
          {
            "word": "Jon",
            "total": 13,
            "number": 4
          },
          {
            "word": "Doe",
            "total": 16,
            "number": 7
          }
        ]
      },
      "pythagorean": {
        "total": 27,
        "number": 9,
        "master": false
      },
      "planet": "Moon",
      "planet_name": "Moon",
      "fit": {
        "number": 2,
        "links": [
          {
            "from": "mulank",
            "from_number": 6,
            "to_number": 2,
            "relation": "enemy",
            "via": [],
            "from_name": "mulank",
            "relation_name": "unfriendly"
          },
          {
            "from": "bhagyank",
            "from_number": 6,
            "to_number": 2,
            "relation": "enemy",
            "via": [],
            "from_name": "bhagyank",
            "relation_name": "unfriendly"
          }
        ],
        "outcome": "difficult",
        "outcome_name": "Not a good fit",
        "reading": "This number does not get along with your own numbers. It may get in your way more than it helps."
      }
    }
  ],
  "ranked": false,
  "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": []
  }
}

What the name numerology API returns

Each spelling's Chaldean total, compound number and single number, with each word added up on its own. The Pythagorean total and number sit beside them.
Each spelling's planet and its fit with the person: good, neutral, mixed or difficult, with a reading.
The links behind each fit: how the mulank and the bhagyank each count the name's number.
POST /v1/name/suggest: spellings of one word that sound the same and reach a number that suits the person. Each one lists its changes.
found, the count of every match, so a limit never hides how many exist.
When no small change works, none says so in a plain sentence, and the current spelling can stay.

Spellings come back in the order you sent them. Suggestions come in a fixed order: fewer changes first, then A to Z. Neither list is ranked, because choosing a name is the person's call.

Name numerology API endpoints

What it uses from your plan

Every numerology answer is a written reading, so it uses reading credits and no calls. The price is the same in every language and at either length. Failed requests are free.

Name checker1 credit
Name spelling suggestions1 credit

Numerology API pricing

Try it free

No code needed

Name numerology calculator
A name's Chaldean and Pythagorean numbers, with other spellings compared against your birth date.
Check my name

All free tools

The rules behind the name numerology API

Names are read in English letters only, and another script, such as Hindi, is refused. The fit has one rule: a friend and no enemy is good, an enemy and no friend is difficult. One of each is mixed, and neither is neutral. Suggestions make at most two changes, using only spelling habits that keep the sound, such as a or aa.

The Chaldean letter values, with no letter worth 9, follow the table in Cheiro's Book of Numbers (1926). Numerology turns a person's name and date of birth into numbers, as described by Encyclopaedia Britannica.

Read the conventions Chaldean vs Pythagorean compared

Terms used here

Who uses it

Related features

From the blog

Name numerology API questions

All questions

How many spellings can I check in one call?

The main name plus up to 10 other spellings, each up to 100 characters. One POST /v1/name call costs 1 reading credit on a live key, however many spellings you send. They come back in the order you sent them, and they are never ranked.

Why is a name in Hindi script refused?

A Hindi name can be written in English letters in more than one way. Each way gives a different number. So the API reads English letters only and refuses other scripts with a 422 error. Spaces, dots, hyphens and apostrophes are fine.

How names are read

Which spelling changes does the suggest route try?

It tries only habits that keep the name sounding the same. These are a or aa, i or ee, u or oo, v or w, and ph or f. V and w are never swapped as the first letter. It can also double the last consonant, or add a silent h after a final a. It makes at most two changes, never two at the end of the word.

What name correction is

Which word of the name does the suggest route change?

The first name, unless you send the part field. It counts words from 0, so part 1 changes the second word. Send targets to aim for chosen numbers from 1 to 9. Leave it out to aim for every number that fits the person well.

What if no spelling suits the person?

Then the suggestions list is empty. The none field holds a plain sentence saying the current spelling can stay. When there are matches, the found field counts all of them, so a limit never hides how many exist.

Is the Pythagorean number read too?

No. Each spelling gets its Pythagorean total and number beside the Chaldean ones, for comparison. Only the Chaldean number gets a fit and a reading. The two systems are never mixed in one number.

What Chaldean numerology is

Does the name checker read compound numbers?

No. The compound number, from 10 to 52, comes back in the compound field, but it is not read. The fit and the reading use the single number. John Doe has compound 34 and name number 7.

What a compound number is

Can the name checker suggest names for a newborn?

Not from scratch. POST /v1/name checks the names you send, and POST /v1/name/suggest respells one word. For a new baby, POST /v1/baby-names searches a list of more than 13,000 names. It returns the ones whose number suits the child, with meanings and Hindi spellings. Both count a name the same Chaldean way.

About the baby name API

Numerology API

Call it with a free test key

Create an account and a test key, then call any endpoint on this page with the sample people. Or try a request in the API reference first.

Get a free API key Open the API reference

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.

01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
One key: the same key, plan and reading credits as the Astrology API