Skip to content
Numerology API

Life path, expression, and Chaldean-ready numerology APIs

Combine numerology with chart data in hybrid spiritual products. Deterministic outputs suitable for reports and AI explainers.

Deterministic numerology without ephemeris cost

Numerology endpoints — life path, expression, soul urge, personal year — reduce names and dates of birth to table-driven numbers. They are among the fastest routes in the catalog because they skip ephemeris work entirely, making them ideal for instant report previews and batch name analysis at scale.

Hybrid spiritual products combine numerology with Kundali data in a single user profile: fetch chart JSON and life path number with the same API key, then let an AI layer explain both without inventing letter values or reduction steps.

Report generators and name analysis apps

PDF and email report pipelines batch-compute expression and soul urge numbers from Unicode names, respecting the reduction rules documented in response metadata. Personal year cycles combine birth month/day with a target calendar year for annual forecast features.

Master numbers 11, 22, and 33 are preserved when reductions land on them — the API returns explicit flags so your UI does not collapse them to single digits silently. Chaldean vs Pythagorean conventions are stamped where name-based systems differ.

Pairing numerology with chart APIs

Numerology does not depend on ayanamsa — but when you ship combined astro-numerology reports, keep chart calls on Lahiri defaults for consistency with the rest of your Vedic features. Cache numerology results by normalized name plus DOB hash; they never change unless inputs change.

The launch free tier covers numerology experimentation alongside heavier Dasha calls — useful when your MVP mixes lightweight number features with chart-first onboarding. See www.navamsha.in/pricing for current tier limits and rate caps.

Example endpoints

GET/api/v1/numerology/life-path

Life path number

1 credit / call
GET/api/v1/numerology/expression

Expression number

1 credit / call
GET/api/v1/numerology/personal-year

Personal year cycle

1 credit / call

What you can build

Name analysis apps

Combine expression and soul urge numbers with Kundali data for hybrid astro-numerology reports.

Report generators

Batch-compute life path, pinnacles, and challenges for PDF report pipelines at minimal credit cost.

AI explainers

Ground numerology chatbots with deterministic number outputs instead of LLM guesswork on letter values.

How it works

  1. 1

    Life path reduces the full date of birth to a single digit (or master number 11/22/33).

  2. 2

    Expression and soul urge endpoints reduce name letters to numbers using Pythagorean or Chaldean tables.

  3. 3

    Personal year cycles compute from birth month/day and the target calendar year.

  4. 4

    All numerology outputs are deterministic — no ephemeris required, making them among the fastest endpoints.

Sample request / response

Request

curl -G "https://api.navamsha.in/api/v1/numerology/life-path" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "date=1995-08-15"

Response (abbreviated)

{
  "life_path_number": 11,
  "master_number": true,
  "calculation": "1+9+9+5+0+8+1+5 = 38 → 3+8 = 11",
  "metadata": { "system": "pythagorean", "formula_version": "1.0" }
}

Built for

    Name analysis apps

    Hybrid astro-numerology AI

    Report generators

FAQ

What is the numerology API used for?

Life path, expression, soul urge, personal year, pinnacles, and challenges from name and date of birth — for report generators and hybrid spiritual apps.

What ayanamsa does numerology use?

Numerology endpoints are independent of ayanamsa — they use deterministic name and DOB reduction rules. Chart APIs on the same platform use Lahiri ayanamsa.

Is there a free tier?

Yes — 10,000 free API calls per month. Numerology endpoints are lightweight (typically 1 credit per call).

How fast are numerology API responses?

Very fast — table-driven calculations with minimal ephemeris work, ideal for batch name analysis and instant report previews.

Pythagorean vs Chaldean — which is default?

Life path uses date reduction (system-agnostic). Name-based endpoints document the active table in response metadata.

Can numerology run without birth time?

Yes — life path and personal year need only date of birth. Expression number needs the full name.

Are master numbers preserved?

11, 22, and 33 are returned as master numbers when the reduction lands on them — not reduced further to 2, 4, or 6.