Life path

Life Path Number API

The life path number is the first thing every numerology app shows, and the easiest to get wrong. Send a date of birth and get it back as JSON, reduced the way numerologists do it, with master numbers 11, 22 and 33 kept.

One request

The life path number comes with every chart. A chart needs a name as well, because the same call returns the name numbers:

curl -X POST https://simplenumerologyapi.com/v1/charts/pythagorean \
  -H 'X-API-Key: nk_…' \
  -H 'content-type: application/json' \
  -d '{"first_name":"María","last_name":"García López","birthdate":"1990-03-12"}'
{
  "life_path_number": 7,
  "birth_day_number": 3,
  "birth_month_number": 3,
  "birth_year_number": 1,
  "karmic_debt_numbers": [13],
  "life_cycles": [
    {"stage": 1, "number": 3, "from_age": 0, "to_age": 29},
    {"stage": 2, "number": 3, "from_age": 30, "to_age": 56},
    {"stage": 3, "number": 1, "from_age": 57, "to_age": null}
  ],
  "…": "more fields"
}

If you only have a birthdate, POST /v1/cycles takes just birthdate and returns the current pinnacle, challenge and life cycle along with the personal year. See personal year numbers.

Why not compute it yourself

Adding up digits takes one line of code. Reducing them the way numerologists do takes more care:

  • Reduce each part first. The month, day and year are reduced separately and then added. Summing all eight digits at once loses master numbers: 1990-03-12 happens to give 7 either way, but many dates do not.
  • Keep 11, 22 and 33. A life path of 11 is not a 2. Master numbers explains when they survive.
  • Flag karmic debt. A 13, 14, 16 or 19 on the way down is reported in karmic_debt_numbers, which naive code throws away.

How to calculate a life path number walks through the method step by step. The API applies it the same way on every request, and golden tests pin the output.

What you get alongside it

The life path number is one of 47 fields. The others that come from the birthdate alone:

Field What it is
birth_day_number The day of birth, reduced
pinnacles Four life stages, with the age each starts and ends
challenges The four matching challenge numbers
life_cycles Three long cycles, with age ranges
bridges.life_path_expression The distance between life path and destiny

Frequently asked questions

Is there a free life path number API?

Yes. The free plan includes 100 charts a month with no card required, and every chart contains the life path number.

Does the API return master numbers for the life path?

Yes. A life path of 11, 22 or 33 is returned as is, not reduced to 2, 4 or 6.

Can I get the life path number from a birthdate only?

The chart endpoint also needs a first and last name, because it calculates the name numbers in the same call. The cycles endpoint needs only a birthdate and returns the current pinnacle, challenge, life cycle and personal year.

Does it also return the meaning of the number?

No. The API returns numbers, not interpretations, so you can write descriptions in your own voice and language.

Start with 100 free charts a month

No card, no trial clock, no expiry date.

Get a free key

Related