New Numerology API

Western numerology

Life Path Number API, with Expression, Soul Urge and More

The life path number API from API for Astrology (apiforastrology.com) gives the Western numbers of numerology.

Updated

© API for Astrology (apiforastrology.com). "Western numbers explained". All rights reserved. Not to be copied or reused.The Pythagorean chartJohn Doe's letters. Each letter is worth its column number.123456789ABCDEFGHIJKLMNOPQRSTUVWXYZJO×2HNDEvowelconsonantLife path68 + 6 + 1 = 15birth dateExpression8John 20 · Doe 15all lettersSoul urge8John 6 · Doe 11vowelsPersonality9John 14 · Doe 4consonants

How the life path number API works

  1. 1Send the full birth name in English letters and the birth date, such as John Doe, August 15, 1990.
  2. 2It adds up the digits of the month, the day and the year one at a time: 8, 6 and 1 give life path 6.
  3. 3Each number comes back with its reading, and the answer names each method where books differ.
POST /v1/western?as_of=2026-10-01200 OK
{
  "life_path": {
    "number": 6
  },
  "expression": {
    "number": 8
  },
  "soul_urge": {
    "number": 8
  },
  "personality": {
    "number": 9
  }
}
John Doe's Western (Pythagorean) numbers: life path, expression, soul urge and personality. Real output for John Doe, born Aug 15, 1990.

How John Doe's life path and name numbers add up

This is the real answer for John Doe, born August 15, 1990. Letters use Pythagorean values: J is 1, O is 6, H is 8, N is 5, D is 4 and E is 5. Each word is added up first, then the words are added.

How John Doe's life path and name numbers add up
NumberHow it adds upResult
Life pathMonth 8. Day 15: 1 + 5 = 6. Year 1990: 1 + 9 + 9 + 0 = 19, then 10, then 1. 8 + 6 + 1 = 15, then 6.6
Expression (all letters)John: 1 + 6 + 8 + 5 = 20, then 2. Doe: 4 + 6 + 5 = 15, then 6. 2 + 6 = 8.8
Soul urge (vowels)John: O is 6. Doe: O + E = 6 + 5 = 11, a master number, so it stays 11. 6 + 11 = 17, then 8.8
Personality (consonants)John: 1 + 8 + 5 = 14, then 5. Doe: D is 4. 5 + 4 = 9.9, with karmic debt 14
MaturityLife path 6 + expression 8 = 14, then 55, with karmic debt 14

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

Find any life path number with the free calculator

Call the life path number 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/western

# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/western?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe","birth_date":"1990-08-15"}'
Response (lists shortened)200 OK
{
  "input": {
    "name": "John Doe",
    "birth_date": "1990-08-15"
  },
  "system": "pythagorean",
  "about": "These are the Western numbers. They use the Pythagorean letter values, where A is 1, B is 2 and so on. The numbers 11, 22 and 33 are master numbers and are…",
  "basis": {
    "letters": "Pythagorean letter values (A=1 ... I=9, J=1 ...).",
    "masters": "11, 22 and 33 are kept; `digit` is the same number reduced to 1-9.",
    "life_path": "Month, day and year are reduced one by one, then added.",
    "name_numbers": "Each word is reduced, then the words are added.",
    "y": "Y counts as a vowel when neither letter beside it is a vowel.",
    "personal_year": "Counted on the calendar year, from January 1.",
    "pinnacles": "The first ends at age 36 minus the life path digit; each later one lasts nine years, and the fourth for life.",
    "life_cycles": "Month, day and year, each reduced (masters kept). The first cycle ends with the first pinnacle, the second 27 years later, and the third runs for life.",
    "karmic_debt": "Karmic debt is looked for in six numbers: life path, expression, soul urge, personality, maturity and birthday. Pinnacles, challenges and life cycles are not…"
  },
  "life_path": {
    "total": 15,
    "number": 6,
    "digit": 6,
    "karmic_debt": [],
    "parts": {
      "month": 8,
      "day": 6,
      "year": 1
    },
    "about": "Your life path number comes from your full birth date. It shows the main road your life tends to follow.",
    "reading": "Your road tends to center on caring for others. Family, home and community often matter most to you."
  },
  "expression": {
    "total": 8,
    "number": 8,
    "digit": 8,
    "karmic_debt": [],
    "words": [
      20,
      15
    ],
    "about": "Your expression number comes from every letter of your full name. It shows your natural talents.",
    "reading": "You have a natural gift for business, managing and handling money."
  },
  "soul_urge": {
    "total": 17,
    "number": 8,
    "digit": 8,
    "karmic_debt": [],
    "words": [
      6,
      11
    ],
    "about": "Your soul urge number comes from the vowels in your name. It shows what you want deep inside.",
    "reading": "Deep inside, you want success and to be respected for what you achieve."
  },
  "personality": {
    "total": 9,
    "number": 9,
    "digit": 9,
    "karmic_debt": [
      {
        "number": 14,
        "reading": "14 points to a lesson about balance. Too much of anything, from food to freedom, tends to cost you."
      }
    ],
    "words": [
      14,
      4
    ],
    "about": "Your personality number comes from the consonants in your name. It shows how people see you before they know you well.",
    "reading": "People tend to see you as open-hearted and generous."
  },
  "maturity": {
    "total": 14,
    "number": 5,
    "digit": 5,
    "karmic_debt": [
      {
        "number": 14,
        "reading": "14 points to a lesson about balance. Too much of anything, from food to freedom, tends to cost you."
      }
    ],
    "about": "Your maturity number adds your life path and expression numbers. It shows what tends to grow stronger after about age 35.",
    "reading": "After about age 35, you tend to want more freedom and change. New places, people and ideas often keep you growing."
  },
  "birthday": {
    "day": 15,
    "number": 6,
    "digit": 6,
    "karmic_debt": [],
    "about": "Your birthday number is the day of the month you were born. It shows one special gift you carry.",
    "reading": "You tend to have a special gift for caring for others. You may be good at looking after people and making any place feel like home."
  },
  "karmic_lessons": {
    "about": "Karmic lessons are the numbers from 1 to 9 that no letter of your name gives. They show skills you may need to build on purpose.",
    "numbers": [
      {
        "number": 2,
        "reading": "No letter gives 2. Patience and working closely with others may need practice."
      },
      {
        "number": 3,
        "reading": "No letter gives 3. Sharing your feelings and ideas out loud may need practice."
      }
    ]
  },
  "hidden_passion": {
    "numbers": [
      5,
      6
    ],
    "count": 2,
    "about": "Your hidden passion is the number that appears most often in the letters of your name. It shows a strong drive you may not talk about.",
    "readings": [
      "5 is about freedom, change, travel and trying new things.",
      "6 is about care, family, home and taking responsibility."
    ]
  },
  "balance": {
    "initials": "JD",
    "total": 5,
    "number": 5,
    "about": "Your balance number comes from the first letter of each part of your name. It shows how you tend to handle hard times.",
    "reading": "5 is about freedom, change, travel and trying new things."
  },
  "challenges": {
    "about": "Your four challenge numbers come from your birth date. Each shows something you may have to work at during part of your life.",
    "items": [
      {
        "id": "first",
        "number": 2,
        "name": "First challenge",
        "reading": "Not taking things too personally."
      },
      {
        "id": "second",
        "number": 5,
        "name": "Second challenge",
        "reading": "Handling freedom wisely and not rushing from one thing to the next."
      }
    ]
  },
  "pinnacles": {
    "about": "Your four pinnacles are long stretches of your life. Each one has its own number and its own focus.",
    "as_of": "2026-10-01",
    "items": [
      {
        "id": 1,
        "number": 5,
        "digit": 5,
        "from_age": 0,
        "to_age": 30,
        "from_year": 1990,
        "to_year": 2020,
        "current": false,
        "reading": "5 is about freedom, change, travel and trying new things."
      },
      {
        "id": 2,
        "number": 7,
        "digit": 7,
        "from_age": 31,
        "to_age": 39,
        "from_year": 2021,
        "to_year": 2029,
        "current": true,
        "reading": "7 is about study, thinking deeply and looking inward."
      }
    ]
  },
  "life_cycles": {
    "about": "Your life cycles are three long stages of your life: your early, middle and later years. Each stage has its own number and its own mood.",
    "as_of": "2026-10-01",
    "items": [
      {
        "id": "early",
        "number": 8,
        "digit": 8,
        "from_age": 0,
        "to_age": 30,
        "from_year": 1990,
        "to_year": 2020,
        "current": false,
        "name": "Early years",
        "reading": "8 is about ambition, money, managing people and real results."
      },
      {
        "id": "middle",
        "number": 6,
        "digit": 6,
        "from_age": 31,
        "to_age": 57,
        "from_year": 2021,
        "to_year": 2047,
        "current": true,
        "name": "Middle years",
        "reading": "6 is about care, family, home and taking responsibility."
      }
    ]
  },
  "personal": {
    "as_of": "2026-10-01",
    "year": {
      "number": 6,
      "about": "Your personal year number shows the theme of this year for you. It changes on January 1.",
      "reading": "A year for home, family and duties. People may lean on you.",
      "do": "Give time to your home and family. Help the people who lean on you, and plan what you can do for them. Fix or improve something at home. Spend time with your…",
      "avoid": "Avoid taking on every duty yourself. Try not to give advice or help where it is not wanted. Do not forget your own rest while you care for others. Avoid…"
    },
    "month": {
      "number": 7,
      "about": "Your personal month number shows the theme of this month for you.",
      "reading": "This month tends to favor rest, study and thinking things over. You may want more quiet time than usual. It is a good time to read, plan and look inward,…"
    },
    "day": {
      "number": 8,
      "about": "Your personal day number shows the theme of this day for you.",
      "reading": "Good for work, money and big decisions."
    }
  },
  "not_computed": [],
  "not_claimed_karmic": "Karmic debt and karmic lessons describe patterns to work on. They are not a claim about a past life.",
  "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 life path number API returns

  • The life path, expression, soul urge, personality, maturity and birthday numbers. Each has its number, which keeps master numbers 11, 22 and 33, and its digit from 1 to 9.
  • Karmic debt numbers (13, 14, 16 and 19) met on the way to a number. Karmic lessons: the numbers no letter of the name gives.
  • Hidden passion, the number that appears most often in the name's letters, and the balance number from the initials.
  • The four pinnacles, with ages, years and which one is current, and the four challenges, which have no ages.
  • The three life cycles, early, middle and later, each with its number, ages, years, a current flag and a reading.
  • The personal year, month and day for today, or for the date you send in as_of.
  • basis, which states each method where books differ, such as when Y counts as a vowel.

Readings come in English or Hindi, at standard or expanded length. Karmic debt and karmic lessons are read as patterns to work on. The answer says they are not a claim about a past life.

Life path number 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.

  • Western numbers3 credits
Numerology API pricing

Try it free

No code needed

  • Life path number calculator

    Your life path number with master numbers kept, plus your expression, soul urge and personality numbers.

    Find my life path

The rules behind the life path number API

These numbers use Pythagorean letter values only, and they never mix with the Chaldean name number. Life path and the name numbers reduce each part first, so a master number stays visible. Y is a vowel when neither letter beside it is a vowel, and W is always a consonant. The first pinnacle ends at 36 minus the life path digit.

The Pythagorean letter values, 1 to 9 in alphabet order, match the table in L. Dow Balliett's The Philosophy of Numbers (1908). The life path reduces the month, the day and the year one by one, then adds them. The same steps appear in L. Dow Balliett's The Philosophy of Numbers (1908).

From the blog

Life path number API questions

All questions
Are master numbers reduced?

No. The Western numbers keep 11, 22 and 33 in the number field. The digit field beside it holds the single digit. So a life path of 11 comes back with number 11 and digit 2. Each part of the date is reduced first, and a part that comes to 11 or 22 is kept.

What master numbers are
Which name should my users enter?

The full name from birth, in English letters. The expression, soul urge and personality numbers come from every word of it. A name with no vowel has no soul urge number, and the answer lists it in not_computed.

When does Y count as a vowel?

When neither letter beside it in the word is a vowel, as in Lynn. In a name such as Maya, Y sits next to a vowel and counts as a consonant. W always counts as a consonant.

Is the life path the same as the bhagyank?

Both come from the full birth date, so their single digits always match. The life path keeps master numbers and reduces the month, day and year first. The bhagyank adds every digit and is read the Indian way, with its own readings.

What a life path number is
Which date are the personal year and the current pinnacle for?

Today, unless you send as_of as YYYY-MM-DD. The date comes back in as_of, and the pinnacle running then has current set to true. The personal year runs on the calendar year, from January 1.

What pinnacles are
Does karmic debt claim a past life?

No. Karmic debt numbers are 13, 14, 16 and 19, met on the way to a number. They and karmic lessons are read as patterns to work on. A sentence in not_claimed_karmic says they are not a claim about a past life.

What karmic debt is
What does a Western numbers call cost?

3 reading credits per live call, in every language and at either length. One call returns every Western number, the challenges, the pinnacles and the personal year. Test keys answer for John Doe and Jane Doe.

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.

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.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    One key: the same key, plan and reading credits as the Astrology API