Numerology API

The endpoint takes the birth date, breaks it into its digits, and sums them, then iteratively reduces the running total down to a single figure — while preserving the master numbers 11, 22 and 33 whenever they surface during the reduction. The response carries the raw uncollapsed total, the final reduced number, an isMaster boolean signalling whether a master number was held back from further reduction, the ordered list of reduction steps so you can render or audit each pass, and a short meaning string for the resulting number. Because every output is derived deterministically from the calendar digits, the same date always yields byte-identical results; the name field accompanies the calculation but the Life Path itself rests entirely on the date. Sibling calculations — expression, soul-urge, personality, birthday, maturity — extend the same arithmetic to the name and other inputs.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ada Lovelace",
  "date": "1990-05-15"
}'

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1990-05-15",
    "lifePath": {
      "raw": 30,
      "reduced": 3,
      "isMaster": false,
      "steps": [
        "1+9+9+0+5+1+5 = 30",
        "3+0 = 3"
      ],
      "meaning": "Creative self-expression…"
    }
  }
}

Reach for this when you need a fast, repeatable numerological reading and want to avoid the latency and non-determinism of anything that touches an ephemeris or a language model. Because the math is trivial and fully deterministic, you can compute it inline on every request, cache it indefinitely keyed on the date, or precompute it in bulk for a whole user base without worrying about drift. It pairs naturally with the rest of the numerology suite: call life-path alongside expression and soul-urge to assemble a complete profile, then store the reduced numbers as durable attributes rather than recomputing them. Good for onboarding flows, profile enrichment and content personalisation where a single grounding number is enough.

Master numbers 11, 22 and 33 are deliberately not reduced to 2, 4 and 6 — the isMaster flag tells you which case occurred so you can branch your copy accordingly. This is the Pythagorean system specifically; the Chaldean and other systems in the suite assign different letter-to-number values and can return a different result for the same input.