Number checks

Mobile Number Numerology API, plus House, Vehicle and Business Numbers

The mobile number numerology API from API for Astrology (apiforastrology.com) adds up a phone, vehicle or house number. It gives the number's planet and how it suits the owner's birth date. The phone number 212 555 0147 adds up to 32, then 5 (Mercury). It also compares up to 5 numbers and checks business names.

Get a free API key Try it in the API reference

Updated Nov 7, 2026

How the mobile number numerology API works

1Send the kind of number, the number as written and the owner's birth date.
2Only the digits are added, so 212 555 0147 adds up to 32, then 5, which is Mercury.
3For John Doe, born August 15, 1990, the answer says 5 is a good fit.

POST /v1/number200 OK

{
  "value": "212 555 0147",
  "total": 32,
  "number": 5,
  "planet": "Mercury",
  "fit": {
    "outcome": "good",
    "reading": "This number gets along well with your own numbers. It tends to support you."
  }
}

A New York mobile number added up, its planet, and how well it fits John Doe's numbers. Real output for A mobile number for John Doe, born Aug 15, 1990.

How the sample numbers add up for John Doe

These are real answers for John Doe, born August 15, 1990. His mulank and bhagyank are both 6 (Venus), and each number is read against them.

How the sample numbers add up for John Doe
Number	How it adds up	Number and fit
Mobile 212 555 0147	2 + 1 + 2 + 5 + 5 + 5 + 0 + 1 + 4 + 7 = 32, then 3 + 2 = 5	5, Mercury: good
Vehicle ABC 4521	The letters A, B and C are left out. 4 + 5 + 2 + 1 = 12, then 1 + 2 = 3	3, Jupiter: neutral
Business name Acme Inc.	Chaldean letters: Acme 13 + Inc 9 = 22, then 2 + 2 = 4	4, Rahu: good
Launch date December 12, 2026	2 + 0 + 2 + 6 + 1 + 2 + 1 + 2 = 16, then 1 + 6 = 7	7, Ketu: neutral

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.”

How mobile number numerology works

Call the mobile number 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/number

# A mobile number for John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/number" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"mobile","value":"212 555 0147","birth_date":"1990-08-15"}'

Response (lists shortened)200 OK

{
  "kind": "mobile",
  "kind_name": "Mobile number",
  "about": "A mobile number is read by adding all its digits.",
  "value": "212 555 0147",
  "digits": "2125550147",
  "total": 32,
  "compound": 32,
  "number": 5,
  "ignored_letters": [],
  "planet": "Mercury",
  "planet_name": "Mercury",
  "person": {
    "birth_date": "1990-08-15",
    "mulank": 6,
    "bhagyank": 6
  },
  "fit": {
    "number": 5,
    "links": [
      {
        "from": "mulank",
        "from_number": 6,
        "to_number": 5,
        "relation": "friend",
        "via": [],
        "from_name": "mulank",
        "relation_name": "friendly"
      },
      {
        "from": "bhagyank",
        "from_number": 6,
        "to_number": 5,
        "relation": "friend",
        "via": [],
        "from_name": "bhagyank",
        "relation_name": "friendly"
      }
    ],
    "outcome": "good",
    "outcome_name": "Good fit",
    "reading": "This number gets along well with your own numbers. It tends to support you."
  },
  "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 mobile number numerology API returns

The digits counted, their total, the compound number and the single number, with its planet.
Any letters in a vehicle or house number, listed in ignored_letters and not counted.
The fit with the owner's mulank and bhagyank (good, neutral, mixed or difficult) and a short reading.
POST /v1/numbers: up to 5 numbers of one kind, each read the same way, in the order sent.
POST /v1/business: a business name read by its letters, with up to 5 sound-alike spellings that suit the owner.
With a launch_date, the number of that date and how it fits the owner.

Compared numbers come back in the order you sent them. They are never ranked, because choosing a number is the owner's call.

Mobile number 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.

Mobile, vehicle, house or business number1 credit
Compare several numbers2 credits
Business name and launch date2 credits

Numerology API pricing

The rules behind the mobile number numerology API

Mobile, vehicle and house numbers count digits only. Letters are listed and left out, because sources disagree on whether they count. A business name is read by its letters in Chaldean, like a person's name. Every check uses the name checker's fit rule, so a number and a name are never judged two ways.

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

Read the conventions

Terms used here

Who uses it

Related features

From the blog

Mobile number numerology API questions

All questions

Do the letters in a plate number count?

No. Only digits count in a mobile, vehicle or house number. Letters are listed in ignored_letters and left out, because sources disagree on whether they count. So the plate ABC 4521 adds up to 12, then 3.

Vehicle number numerology

Can I send spaces, dashes or a country code?

Spaces and dashes are fine, since only digits are added. A country code is made of digits, so it changes the total. A number with no digit other than zero is refused.

Whose birth date should I send?

The owner's, meaning the person who uses the number. The fit reads the number against that person's mulank (birth day number) and bhagyank (destiny number). For a business, send the owner's birth date too.

How many numbers can I compare at once?

Up to 5 of one kind in POST /v1/numbers. Each is read just as POST /v1/number reads one, and they come back in the order you sent them. They are never ranked, because choosing a number is the owner's call.

How is a business name read?

By its letters, in Chaldean, the same way as a person's name. Acme Inc. adds up to 22, then 4, which is Rahu. POST /v1/business also offers up to 5 sound-alike spellings of the first word that suit the owner.

Business name numerology

What does the launch date add?

Send launch_date with POST /v1/business, and the answer adds that date's number and how it fits the owner. December 12, 2026 adds up to 16, then 7. It uses the same fit rule as a phone number.

What a launch date number is

What does each number check cost?

On a live key, POST /v1/number costs 1 reading credit. POST /v1/numbers and POST /v1/business cost 2 each. The price is the same in every language. Test keys answer for the sample people only, and each test call counts as 1 test call.

See numerology credits

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