Use case

Business name numerology API for naming tools

The business name numerology API from API for Astrology (apiforastrology.com) checks a company name against its owner's birth date. It adds up the name in Chaldean, the letter values Indian numerology uses, and says how well it fits. It suggests up to 5 sound-alike spellings that suit the owner better, and checks the launch date.

Get a free API key Talk to us

Updated Oct 28, 2026

How it works

1Your tool sends the business name and the owner's date of birth.
2The API adds up the letter values and reads the total against the owner's numbers.
3It returns the fit, spellings that keep the sound, and how the launch date suits the owner.

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.

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 business name in English letters and the owner's date of birth. Add a launch date if there is one.
You get	The name's number and how well it suits the owner, up to 5 sound-alike spellings, and how the launch date suits the owner.
It costs	2 credits a name check. A month of dates is 1 credit, and 5 phone numbers 2 credits.
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 business name numerology to a naming tool

01
Check the name and the launch date
POST /v1/business2 credits
The name's number and its fit with the owner. Up to 5 spellings of the first word that sound the same and suit the owner better. Send launch_date to see how that date suits the owner too.
02
Try more spellings
POST /v1/name/suggest1 credit
For another word of the name, set part (0 is the first word). Set limit for up to 50 spellings, or targets for the numbers to aim for.
03
Pick a launch date
POST /v1/dates1 credit
Every date of a month read against the owner, with the good dates listed. Send the date the owner picks as launch_date.
04
Compare phone numbers
POST /v1/numbers2 credits
Up to 5 mobile numbers for the business line, each with its number and its fit. They come back in the order sent and are never ranked.

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

Step 1 in code: check the name and the launch date

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/business

# Acme Inc., owned by John Doe, born Aug 15, 1990, opening Dec 12, 2026
curl -X POST "https://apiforastrology.com/api/numerology/v1/business" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Inc.","birth_date":"1990-08-15","launch_date":"2026-12-12"}'

Response (lists shortened)200 OK

{
  "name": {
    "kind": "business",
    "kind_name": "Business name",
    "about": "A business name is read from its letters, the same way as a person's name.",
    "value": "Acme Inc.",
    "name": "Acme Inc.",
    "total": 22,
    "compound": 22,
    "number": 4,
    "master": true,
    "planet": "Rahu",
    "planet_name": "Rahu",
    "person": {
      "birth_date": "1990-08-15",
      "mulank": 6,
      "bhagyank": 6
    },
    "fit": {
      "number": 4,
      "links": [
        {
          "from": "mulank",
          "from_number": 6,
          "to_number": 4,
          "relation": "friend",
          "via": [
            "Rahu"
          ],
          "from_name": "mulank",
          "relation_name": "friendly"
        },
        {
          "from": "bhagyank",
          "from_number": 6,
          "to_number": 4,
          "relation": "friend",
          "via": [
            "Rahu"
          ],
          "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": []
    }
  },
  "suggestions": [
    {
      "name": "Aacme Inc.",
      "word": "Aacme",
      "changes": [
        {
          "code": "double_a",
          "from": "a",
          "to": "aa",
          "at": 0,
          "name": "Doubled an a"
        }
      ],
      "total": 23,
      "compound": 23,
      "number": 5,
      "planet": "Mercury",
      "planet_name": "Mercury",
      "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."
      }
    }
  ],
  "found": 1,
  "suggest_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.",
  "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.",
  "launch": {
    "date": "2026-12-12",
    "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."
    },
    "about": "A launch date adds up to its own number. It is read against the owner's mulank and bhagyank."
  },
  "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

Write the name in English letters. Spaces, dots, hyphens and apostrophes are fine. A digit or an & sign is refused, so spell it out.
Show the changes list with each spelling, so the owner sees what changed and can say the name aloud.
Spellings come in a fixed order: fewer changes first, then A to Z. They are never ranked, so do not label one as the best.
Show not_claimed_spelling next to the suggestions. It says that a new spelling changes the number of the name, not the person.
Ask for the owner's date of birth. The name, the dates and the phone numbers are all read against it.

Where the rules come from

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.

What it costs

One full check, with the name, a month of dates and 5 phone numbers, costs 5 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

From the blog

Oct 27, 2026 · 11 min read
Business Name Numerology: What a Name Number API Returns
Business name numerology for Acme Inc.: how a company name becomes a number and fits its owner.
Read

Common questions

All questions

How is a business name turned into a number?

The same way as a person's name. Each letter gets its Chaldean value, and the values are added until one digit is left. Acme Inc. adds up to 22, then 4, whose planet is Rahu.

What business name numerology is

What does a good fit with the owner mean?

The name's number is read against the owner's mulank (birth day number) and bhagyank (destiny number). A friendly link and no unfriendly one is good. Acme Inc. is a good fit for John Doe, whose mulank and bhagyank are both 6.

How a fit is decided

Which spellings does the API suggest?

The API tries only spelling habits that keep the sound. They are a or aa, i or ee, u or oo, and ph or f. It also tries v or w, but not as the first letter. Then it tries a doubled last consonant, or a silent h after a final a. At most two changes are made. For John Doe, Acme Inc. can become Aacme Inc., which adds up to 5.

About spelling suggestions

Can the business name check suggest spellings for a word other than the first?

POST /v1/business changes only the first word and returns up to 5 spellings. For another word, send the name to POST /v1/name/suggest with part set to that word's place, counting from 0. Set limit for up to 50 spellings.

See the names reference

How does the API check a launch date?

Send launch_date with the name. The date's digits are added until one is left, and that number is read against the owner. December 12, 2026 adds up to 7, a neutral fit for John Doe. To find a better date, POST /v1/dates reads every date of a month for the owner.

What a launch date number is

Can we compare phone numbers for the business?

Yes. POST /v1/numbers reads up to 5 mobile, vehicle or house numbers of one kind against the owner. 212 555 0147 adds up to 5, a good fit for John Doe. 212 555 0199 adds up to 3, a neutral one.

About number checks

Does the API pick the best name?

No. Names, spellings and numbers come back in a fixed order, and the answer says ranked: false. The choice is the owner's. The answer also says that a new spelling changes the number of the name, not the person.

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

Business name numerology API for naming tools

How it works

What you send, what you get, what it costs

How to add business name numerology to a naming tool

Check the name and the launch date

Try more spellings

Pick a launch date

Compare phone numbers