Core numbers

Name number in numerology

The name number is the total of the letter values in a name, added down to one digit. Indian numerology counts it with the Chaldean letter values. It reads the number as how a name shapes the way people take a person. John Doe adds up to 34, so his name number is 7.

Updated Oct 28, 2026

More terms in Core numbers

Name number: how the API works it out

The API reads the name number in the Chaldean system by default, the letter table Indian numerology uses. Each letter gets a value from 1 to 8. The API adds them, then adds the digits of the total until one digit is left.

For John Doe, John is 18 and Doe is 16. The total is 34, and 3 plus 4 gives 7, ruled by Ketu. Send the full name as the person writes and uses it, in English letters.

Spaces, dots, hyphens and apostrophes are fine. Any other script is refused with an error. A guessed spelling would give a number for a name the person does not use.

POST /v1/profile returns it under name_number. The chaldean block holds the total, the compound number and the single number. It also has the master flag and each word on its own.

The planet, an about line and a short reading come with it. The pythagorean block sits beside it with numbers only and read set to false. For John Doe it adds up to 8.

POST /v1/name checks the name and up to 10 other spellings in one call. Each one gets its number and a fit: good, neutral, mixed or difficult. The fit says how the number gets along with the person's mulank (birth day number) and bhagyank (destiny number).

John Doe's 7 is neutral for him. The spelling John Dow gives 8, which is a good fit.

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 checker. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, with two other spellings.

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"]}'

Answer (long 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": []
  }
}

Where the API returns it

POST	/v1/name	Name checker
POST	/v1/profile	Core numbers and Lo Shu grid
POST	/v1/report	Numerology report (HTML or JSON)

Feature page: Name checker. Try it free: Name numerology calculator. 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.

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