Numerology

Calculate numerology profiles including life path, expression, soul urge, personality, and compatibility numbers.

Required Module

All numerology endpoints require the module:numerology module to be enabled for your organization.

Full Profile

Calculate a complete numerology profile for a person based on their birth date and full name:

curl -X POST "https://api.astroapi.cloud/api/numerology/profile" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "fullName": "Jane Elizabeth Smith",
    "language": "en",
    "includeText": true
  }'

const response = await fetch("https://api.astroapi.cloud/api/numerology/profile", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        fullName: "Jane Elizabeth Smith",
        language: "en",
        includeText: true
    })
});
const data = await response.json();

Parameters

Parameter	Type	Required	Description
dateTime	string	Yes	Birth date and time in YYYY-MM-DDTHH:mm format
fullName	string	Yes	Full birth name (as on birth certificate)
language	string	No	Language code for interpretation text (default: "en")
includeText	boolean	No	Include interpretation text (default: false)

Response

{
    "data": {
        "lifePathNumber": {
            "value": 7,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 34,
            "calculation": "1+9+9+0+0+6+1+5 = 31, 3+1 = 4... (full reduction)",
            "text": "The Life Path 7 is the path of the seeker..."
        },
        "expressionNumber": {
            "value": 11,
            "isMasterNumber": true,
            "isKarmicDebt": false,
            "reducedFrom": 11,
            "calculation": "J(1)+A(1)+N(5)+E(5)+... = 47, 4+7 = 11",
            "text": null
        },
        "soulUrgeNumber": {
            "value": 6,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 15,
            "calculation": "Vowels: A(1)+E(5)+E(5)+I(9)+... = 24, 2+4 = 6",
            "text": null
        },
        "personalityNumber": {
            "value": 5,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 23,
            "calculation": "Consonants: J(1)+N(5)+... = 23, 2+3 = 5",
            "text": null
        },
        "birthdayNumber": {
            "value": 6,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 15,
            "calculation": "Day: 15, 1+5 = 6",
            "text": null
        },
        "personalYear": {
            "value": 3,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 12,
            "calculation": "6+15+2024 reduced",
            "text": null
        },
        "personalMonth": {
            "value": 9,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 9,
            "calculation": "Personal year (3) + current month (6) = 9",
            "text": null
        },
        "personalDay": {
            "value": 4,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 13,
            "calculation": "Personal month (9) + current day (13) = 22, 2+2 = 4",
            "text": null
        },
        "karmicDebtNumbers": [13, 16],
        "masterNumbers": [11]
    }
}

NumerologyNumber Object

Field	Type	Description
value	number	The final numerology number
isMasterNumber	boolean	Whether this is a master number (11, 22, 33)
isKarmicDebt	boolean	Whether this is a karmic debt number (13, 14, 16, 19)
reducedFrom	number	The number before final reduction
calculation	string	Step-by-step calculation explanation
text	string | null	Interpretation text (only if includeText: true)

---

Life Path Number

Calculate the life path number from a birth date:

curl -X POST "https://api.astroapi.cloud/api/numerology/life-path" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "language": "en",
    "includeText": true
  }'

Parameters

Parameter	Type	Required	Description
dateTime	string	Yes	Birth date and time in YYYY-MM-DDTHH:mm format
language	string	No	Language code for interpretation text
includeText	boolean	No	Include interpretation text

---

Expression Number

Calculate the expression number from a full name using Pythagorean numerology:

curl -X POST "https://api.astroapi.cloud/api/numerology/expression" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith",
    "language": "en",
    "includeText": true
  }'

Parameters

Parameter	Type	Required	Description
fullName	string	Yes	Full birth name
language	string	No	Language code for interpretation text
includeText	boolean	No	Include interpretation text

---

Soul Urge Number

Calculate the soul urge (heart's desire) number from the vowels in a name:

curl -X POST "https://api.astroapi.cloud/api/numerology/soul-urge" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith"
  }'

---

Personality Number

Calculate the personality number from the consonants in a name:

curl -X POST "https://api.astroapi.cloud/api/numerology/personality" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith"
  }'

---

Birthday Number

Calculate the birthday number from the day of birth:

curl -X POST "https://api.astroapi.cloud/api/numerology/birthday" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30"
  }'

---

Personal Cycles

Calculate personal year, month, and day cycles for timing and planning:

curl -X POST "https://api.astroapi.cloud/api/numerology/personal-cycles" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "currentDate": "2024-06-15"
  }'

Parameters

Parameter	Type	Required	Description
dateTime	string	Yes	Birth date and time in YYYY-MM-DDTHH:mm format
currentDate	string	No	Reference date in YYYY-MM-DD format (default: today)

Response

{
    "data": {
        "personalYear": {
            "value": 3,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 12,
            "calculation": "birth month (6) + birth day (15 → 6) + current year (2024 → 8) = 20, 2+0 = 2... reduced to 3",
            "text": null
        },
        "personalMonth": {
            "value": 9,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 9,
            "calculation": "Personal year (3) + current month (6) = 9",
            "text": null
        },
        "personalDay": {
            "value": 4,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 13,
            "calculation": "Personal month (9) + current day (15 → 6) = 15, 1+5 = 6... reduced to 4",
            "text": null
        }
    }
}

---

Compatibility

Calculate numerological compatibility between two people based on their life path numbers:

curl -X POST "https://api.astroapi.cloud/api/numerology/compatibility" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime1": "1990-06-15T14:30",
    "dateTime2": "1988-03-22T09:15"
  }'

const response = await fetch("https://api.astroapi.cloud/api/numerology/compatibility", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime1: "1990-06-15T14:30",
        dateTime2: "1988-03-22T09:15"
    })
});
const data = await response.json();

Parameters

Parameter	Type	Required	Description
dateTime1	string	Yes	First person's birth date and time in YYYY-MM-DDTHH:mm format
dateTime2	string	Yes	Second person's birth date and time in YYYY-MM-DDTHH:mm format

Response

{
    "data": {
        "person1LifePath": 7,
        "person2LifePath": 3,
        "compatibilityScore": 72,
        "relationship": "good",
        "description": "Life Path 7 and Life Path 3 can form a complementary partnership. The 7 brings depth and introspection while the 3 adds creativity and social energy..."
    }
}

Compatibility Ratings

Rating	Score Range	Description
"excellent"	85–100	Highly compatible life path numbers
"good"	65–84	Good compatibility with complementary energies
"moderate"	45–64	Moderate compatibility, requires understanding
"challenging"	0–44	Challenging dynamic, growth through contrast

---

Master Numbers

Master numbers (11, 22, 33) are not reduced further in the standard calculation. They carry amplified energy and significance.

Master Numbers

When a calculation results in 11, 22, or 33, the isMasterNumber flag is set to true and the value is kept as-is. The reducedFrom field will equal value in this case.

Karmic Debt Numbers

Karmic debt numbers (13, 14, 16, 19) indicate lessons carried from past lives. When present, the isKarmicDebt flag is set to true.

Karmic Number	Reduced To	Theme
13	4	Hard work and discipline
14	5	Responsible use of freedom
16	7	Ego surrender and spiritual growth
19	1	Independence and self-reliance