Core numbers
Compound number in numerology
Updated
Compound number: how the API works it out
The API returns the compound number in the compound field wherever it adds up letters or digits. It starts from the full total. If the total is from 10 to 52, that total is the compound number.
If it is larger, the API adds its digits until it is 52 or less. A total below 10 has no compound number, and the field is null. That can also happen when a large total folds down to a single digit.
John Doe's Chaldean name adds up to 34, so his compound number is 34 and his single number is 7. The mobile number 212 555 0147 adds up to 32. So its compound number is 32 and its single number is 5.
POST /v1/name returns it for each spelling, and POST /v1/profile returns it under name_number. POST /v1/number returns it for a mobile, vehicle or house number or a business name. POST /v1/numbers and POST /v1/business carry it inside each check.
The API does not read compound numbers yet. It returns the value with no reading text, and the profile says so in not_included.compound_meanings. Every fit and every reading comes from the single digit instead.
So show the compound number as a plain fact, and do not label it good or bad in your app.
Get it from the 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"]}'{
"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/number | Mobile, vehicle, house or business number |
| POST | /v1/profile | Core numbers and Lo Shu grid |
Feature page: Name checker. The rules the API follows are on the conventions page.
Related terms
From the blog

· 13 min read
Vehicle Number Numerology: What Counts on a Plate
Vehicle number numerology for car and bike plates like RJ14 CD 4521.
Read
· 11 min read
House Number Numerology for Real-Estate and Rental Apps
House number numerology for apartments like B-402, 12A and 1504.
Read
· 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
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.
Your first answer
John Doe, born Aug 15, 1990
- 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