Use case

Numerology API for phone, vehicle and house number sellers

The numerology API from API for Astrology (apiforastrology.com) checks phone, vehicle and house numbers against a buyer's birth date. Compare up to 5 numbers in one call, each with its planet and how well it suits the buyer. Numbers are never ranked, so the buyer chooses. Business names can be checked against their owner too.

Get a free API key Talk to us

Updated Nov 7, 2026

How it works

1The buyer gives a date of birth, and your site sends it with the numbers for sale.
2The API adds up each number's digits and reads the total against the buyer's own numbers.
3Each number comes back with its planet and its fit: good, neutral, mixed or difficult.

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.

What you send, what you get, what it costs

What you send, what you get and what it costs in reading credits
You send	The buyer's date of birth and up to 5 mobile, vehicle or house numbers of one kind.
You get	Each number's total, its single digit and planet, and how well it suits the buyer, in the order sent. Never ranked.
It costs	2 credits to compare up to 5 numbers. The full check of one number is 1 credit.
Credits in a plan	The Free plan has 150 reading credits a month. Paid plans have more: Starter 1,000, Growth 5,000, Scale 22,000. Failed calls are free.

How to add numerology checks to a number shop

01
Compare the numbers in stock
POST /v1/numbers2 credits
Up to 5 mobile, vehicle or house numbers of one kind. Each comes back with its total, its number and its fit with the buyer. They come back in the order sent and are never ranked.
02
Show the full check for one number
POST /v1/number1 credit
The number the buyer picks, with how its digits add up, its planet and a short reading of its fit. Letters are not counted. The plate ABC 1234 adds up to 10, then 1, and the answer lists A, B and C in ignored_letters.
03
Check a business name
POST /v1/business2 credits
A business name read against its owner, the same way as a person's name. It also gives up to 5 spellings of the first word that sound the same and suit the owner better.

Credits per flow: 5 credits for one of each call above, on a live key.

Step 1 in code: compare the numbers in stock

Send the details as JSON with your API key in the Authorization header. The other steps work the same way. Each one links to its page in the API reference.

POST /v1/numbers

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

Response (lists shortened)200 OK

{
  "kind": "mobile",
  "kind_name": "Mobile number",
  "person": {
    "birth_date": "1990-08-15",
    "mulank": 6,
    "bhagyank": 6
  },
  "checks": [
    {
      "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": []
      }
    },
    {
      "kind": "mobile",
      "kind_name": "Mobile number",
      "about": "A mobile number is read by adding all its digits.",
      "value": "212 555 0199",
      "digits": "2125550199",
      "total": 39,
      "compound": 39,
      "number": 3,
      "ignored_letters": [],
      "planet": "Jupiter",
      "planet_name": "Jupiter",
      "person": {
        "birth_date": "1990-08-15",
        "mulank": 6,
        "bhagyank": 6
      },
      "fit": {
        "number": 3,
        "links": [
          {
            "from": "mulank",
            "from_number": 6,
            "to_number": 3,
            "relation": "neutral",
            "via": [],
            "from_name": "mulank",
            "relation_name": "neutral"
          },
          {
            "from": "bhagyank",
            "from_number": 6,
            "to_number": 3,
            "relation": "neutral",
            "via": [],
            "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."
      },
      "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": []
      }
    }
  ],
  "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": []
  }
}

Tips for going live

Send the kind with every number: mobile, vehicle or house. The answer's about line says how that kind is read.
Numbers come back in the order sent, and the answer says ranked: false. Do not label one as the best. Show each fit and let the buyer choose.
For a business name alone, send POST /v1/number with kind set to business and the name as value. It costs 1 credit.
Some buyers want a number with the digits missing from their Lo Shu grid. The grid is a 3 by 3 square filled from the birth date. POST /v1/profile lists them in loshu.number_tip, with a line saying this is a popular belief, not a promise.
Ask for the buyer's date of birth before you show any fit. Every check is read against it, and a call without birth_date gets a 422 error.
Show the not_claimed line near the results. It says that numbers describe tendencies, not fixed events.

Where the rules come from

The mulank (birth day number) is the day of birth, added down to one digit. The 1st, 10th, 19th and 28th all give 1, as in Cheiro's Book of Numbers (1926). The Lo Shu square holds the numbers 1 to 9 once each. Every line adds to 15, as shown by Wolfram MathWorld.

What it costs

Comparing up to 5 numbers costs 2 credits, and the full check of the one picked adds 1 credit. A business name with spellings costs 2 credits.

Numerology uses reading credits from your plan, never calls, and the same key as the Astrology API. Test keys are free, with 1,000 test calls a month, and answer for the sample people. Failed requests are free.

Numerology API pricing

Features used here

Number checksMobile, vehicle, house and business numbers

Common questions

All questions

How is a phone number turned into one number?

All its digits are added, then the total is added again until one digit is left. 212 555 0147 adds up to 32, then 5, whose planet is Mercury. For John Doe that is a good fit.

About number checks

What happens to the letters on a vehicle number?

They are not counted. Only the digits are added, and the letters come back in ignored_letters. ABC 1234 adds up to 10, then 1, whose planet is the Sun. For John Doe that is a difficult fit. A house number works the same way: B-402 adds up to 6, Venus, a good fit for him.

What vehicle number numerology is

Can we check more than 5 numbers?

One call to POST /v1/numbers takes up to 5 numbers of one kind and costs 2 credits. A sixth number gets a 422 error, so split a longer list into calls of 5.

See numerology credits

Can we show a number's fit before the buyer gives a birth date?

No. A fit says how a number gets along with one person, so every check needs birth_date. Without it, the API answers with a 422 error that names the field. Ask for the date of birth first, then show the fits.

How a fit is decided

Which numbers suit a buyer's missing digits?

POST /v1/profile reads the buyer's Lo Shu grid, a 3 by 3 square filled from the birth date. Its loshu.number_tip lists the digits the birth date does not have. Many buyers look for a number that has them. The answer says this is a popular belief, not a promise.

See a grid's missing digits in the free calculator

Does the API say which number is best?

No. Numbers come back in the order you sent them, and the answer says ranked: false. Each one has its own fit: good, neutral, mixed or difficult. The buyer chooses.

Can we check a business name for sale?

Yes. Send POST /v1/number with kind set to business and the name in English letters as value. It reads the name against the owner's birth date for 1 credit. POST /v1/business also suggests spellings and checks a launch date, for 2 credits.

What business name numerology is

Numerology API

Start with a free test key

Create an account and a test key, then try each step above with the sample people. Need more than the largest plan? Write to us.

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