Quick Start Playground SDK MCP Setup Free Templates AGENTS.md

Life Path Number API

Most important numerology calculation

POST/numerology/life-pathPOST/numerology/expressionPOST/numerology/personal-yearPOST/numerology/chartPOST/numerology/soul-urgePOST/numerology/personalityPOST/numerology/birth-dayPOST/numerology/maturityPOST/numerology/karmic-debtPOST/numerology/karmic-lessonsPOST/numerology/bridgeGET/numerology/compound-number/{number}

Get API Key Try it live

Remote MCP server OpenAPI schema

Rated 4.5 by 127 developers

Includedwith every plan(at no extra cost)

Astrology Vedic Tarot Human Design Forecast Biorhythm I-Ching Crystals Dreams Angel Numbers Location

828 gold-standard tests, NASA JPL verified

12 domains, 1 API key

llms.txt for AI agents

Calculate your Life Path number from your birth date using Pythagorean numerology. This is the most significant number in your numerology chart, revealing your life purpose, natural talents, and destiny path. Automatically detects Master Numbers (11, 22, 33) and Karmic Debt numbers (13, 14, 16, 19). Returns comprehensive interpretation including personality traits, strengths, challenges, career guidance, relationship compatibility, and spiritual insights. Perfect for numerology apps, birth chart calculators, life purpose discovery tools, personal development platforms, and astrology services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.

Request

POST /api/v2/numerology/life-path

Parameters

Parameter	Type	Description
langquery	string enum	Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English. Default `en`.

Request body

Field	Type	Description
year*	integer	Birth year between 100 and 2100. Supports historical figures like Einstein (1879) and Shakespeare (1564).
month*	integer	Birth month (1-12)
day*	integer	Birth day (1-31)

Example request

POST /numerology/life-path

{
  "year": 1990,
  "month": 7,
  "day": 15
}

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

200 OK

{
  "number": 5,
  "calculation": "Month: 7, Day: 15 → 1+5 = 6, Year: 1990 → 1+9+9+0 = 19 → 1+9 = 10 → 1+0 = 1 → 7+6+1=14 → 5",
  "type": "single",
  "hasKarmicDebt": false,
  "meaning": {
    "title": "The Adventurer",
    "keywords": [
      "adventurous",
      "freedom",
      "versatile",
      "dynamic",
      "curious"
    ],
    "description": "In the span of single-digit numbers 1 to 9, 5 is the number in the exact middle. It acts as a go-between and a pivotal point of change...",
    "strengths": [
      "Curious",
      "Adaptable",
      "Social"
    ],
    "challenges": [
      "Non-committal",
      "Unreliable",
      "Directionless"
    ],
    "career": "Life Path 5 thrives in careers that offer freedom, variety, and constant stimulation...",
    "relationships": "Life Path 5 individuals are exciting, charming, and freedom-loving partners...",
    "spirituality": "Five is the rebel, the traveler, the agent of change. It vibrates with adventure and liberation..."
  }
}

Response fields

Field	Type	Description
number*	number	Your Life Path number, the single most important number in Pythagorean numerology. Values range from 1 to 9 for single digits, or 11, 22, 33 for Master Numbers.
calculation*	string	Full step-by-step breakdown of the 3-Cycle Pythagorean reduction. Shows how month, day, and year each reduce independently before combining into the final Life Path number.
type*	string enum	Whether this is a standard single-digit number (1 to 9) or a Master Number (11, 22, 33). Master Numbers carry amplified spiritual significance and are never reduced further.
hasKarmicDebt*	boolean	Indicates whether a Karmic Debt number (13, 14, 16, or 19) appeared during the reduction chain. Karmic Debt reveals past-life challenges carried into this lifetime.
karmicDebtNumber	number	The specific Karmic Debt number detected during reduction, if any. Each debt number (13, 14, 16, 19) represents a distinct past-life lesson requiring resolution.
karmicDebtMeaning	object	Detailed interpretation of the Karmic Debt number when present. Only returned when hasKarmicDebt is true.
karmicDebtMeaning.description*	string	Title describing the karmic debt theme and core past-life pattern.
karmicDebtMeaning.challenge*	string	The specific challenge or pattern from past lives that must be confronted.
karmicDebtMeaning.resolution*	string	Practical guidance for resolving the karmic debt and transforming the challenge into growth.
meaning*	object
meaning.title*	string	Numerology archetype name for this Life Path number. Encapsulates the core identity and energy in a single phrase, such as "The Leader" for 1 or "The Master Builder" for 22.
meaning.keywords*	array of string	Ten defining personality traits and energetic themes associated with this number. Useful for quick personality snapshots, tag clouds, and compatibility matching.
meaning.description*	string	In-depth 300 to 500 word interpretation covering personality, purpose, and life themes. Written by numerology experts with decades of practice. Suitable for full-page readings and detailed reports.
meaning.strengths*	array of string	Core strengths and positive qualities. Each entry includes a trait name followed by a detailed explanation of how it manifests in daily life.

Show all fields

Field	Type	Description
meaning.challenges*	array of string	Growth areas and shadow qualities to be aware of. Each entry names the challenge and explains its root cause and how to work through it constructively.
meaning.career*	string	Tailored career guidance covering ideal industries, roles, and work environments. Includes specific job titles and explains why certain professional paths align with this number.
meaning.relationships*	string	Love, friendship, and family dynamics. Covers romantic compatibility with other Life Path numbers, communication style, and the key relationship lessons for this number.
meaning.spirituality*	string	Spiritual path, soul lessons, and recommended practices. Explores the deeper purpose behind this number and offers guidance for personal growth and inner alignment.

Supported options

lang

entrdeeshiptfrru

Call it in your language in seconds.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.numerology.calculateLifePath({ body: { year: 1990, month: 7, day: 15 } })

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.numerology.calculate_life_path(year=1990, month=7, day=15)

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->numerology->calculateLifePath(year: 1990, month: 7, day: 15);

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Numerology.LifePath.PostAsync(new() { /* request fields above */ });

Install: dotnet add package RoxyApi.Sdk

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Numerology.CalculateLifePath(ctx, nil, roxyapi.CalculateLifePathJSONRequestBody{ /* request fields above */ })

Install: go get github.com/RoxyAPI/sdk-go

cURL

curl -X POST "https://roxyapi.com/api/v2/numerology/life-path" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":7,"day":15}'

Prefer to try before you write code? Run this Numerology endpoint live in the API playground and inspect a real production response.

More Life Path Number endpoints

The Life Path Number API bundles these related endpoints under one key.

POST/numerology/expression

Calculate Expression number - Natural talents and life goals

Calculate your Expression (Destiny) number from your full birth name using Pythagorean numerology. This number reveals your natural talents, abilities, and life goals. It shows what you came here to do and what tools you have to accomplish your life purpose. Returns comprehensive interpretation including personality traits, career paths, relationship dynamics, and spiritual insights. Automatically detects Master Numbers (11, 22, 33). Perfect for name numerology apps, career guidance tools, personal development platforms, and talent assessment services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.

Try it live

POST/numerology/personal-year

Calculate Personal Year - Annual cycle and forecast for current year

Calculate your Personal Year number from your birth month, day, and current year using Pythagorean numerology. Personal Year runs in 9-year cycles (1-9) and reveals the theme, opportunities, and challenges for the current year. Each year has a specific energy and lessons. Returns comprehensive annual forecast including year theme, opportunities, challenges, and actionable advice. Perfect for yearly planning apps, life coaching platforms, astrology services, and personal development tools. Get detailed forecasts for all 9 Personal Year cycles with practical guidance.

Try it live

POST/numerology/chart

Generate Complete Numerology Chart - Full profile analysis

Generate a comprehensive numerology chart combining all major calculations: Life Path, Expression, Soul Urge, Personality, Birth Day, Maturity, Karmic Lessons, Karmic Debt, and Personal Year. This single endpoint provides everything needed for a full numerology reading. Returns detailed interpretations for all numbers, karmic analysis, yearly forecast, and holistic summary. Perfect for numerology apps, complete reading services, birth chart generators, and comprehensive analysis tools. Save multiple API calls by getting the full chart in one request. Ideal for generating PDF reports or detailed user profiles.

Try it live

POST/numerology/soul-urge

Calculate Soul Urge number - Inner motivations and desires

Calculate your Soul Urge (Heart Desire) number from the vowels in your birth name using Pythagorean numerology. This number reveals your innermost desires, motivations, and what your soul truly wants to experience. It shows what drives you from within, your emotional needs, and what brings you fulfillment. Returns comprehensive interpretation including personality traits, emotional needs, relationship desires, and spiritual longings. Automatically detects Master Numbers (11, 22, 33). Perfect for self-discovery apps, emotional intelligence tools, relationship counseling platforms, and personal development services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.

Try it live

POST/numerology/personality

Calculate Personality number - How others perceive you

Calculate your Personality number from the consonants in your birth name using Pythagorean numerology. This number reveals how others perceive you, your outer personality, and first impressions you make. It represents the mask you show the world and your social persona. Returns comprehensive interpretation including public image, social dynamics, professional presence, and relationship first impressions. Automatically detects Master Numbers (11, 22, 33). Perfect for personal branding apps, social skills training, professional development platforms, and communication coaching services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.

Try it live

POST/numerology/birth-day

Calculate Birth Day number - Special talents from day of birth

Calculate your Birth Day number from the day you were born (1-31) using Pythagorean numerology. This number reveals special talents and abilities you possess from birth. It shows natural gifts that can help you achieve your life purpose. Returns comprehensive interpretation including innate talents, natural abilities, career advantages, and how to leverage your special gifts. Automatically detects Master Numbers (11, 22) and reduces double-digit days. Perfect for talent discovery apps, career counseling platforms, personal development services, and skill assessment tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, and 22.

Try it live

POST/numerology/maturity

Calculate Maturity number - Who you become in later life

Calculate your Maturity (Realization) number by adding Life Path and Expression numbers using Pythagorean numerology. This number reveals who you become in the second half of life, typically manifesting after age 35-40. It shows the ultimate goal of personal development and mature self-expression. Returns comprehensive interpretation including life transformation, mature personality, later-life purpose, and wisdom development. Automatically detects Master Numbers (11, 22, 33). Perfect for life coaching apps, midlife guidance platforms, personal development services, and aging wisdom tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.

Try it live

POST/numerology/karmic-debt

Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)

Check for Karmic Debt numbers (13, 14, 16, 19) in Life Path, Expression, Soul Urge, or Personality calculations using Pythagorean numerology. Karmic debt indicates challenges carried from past lives that must be resolved in this lifetime. These numbers appear during reduction and represent specific lessons and tests. Returns comprehensive analysis including debt descriptions, challenges to overcome, and resolution guidance. Perfect for spiritual growth apps, karmic astrology platforms, past life exploration services, and personal transformation tools. Get detailed meanings for all four karmic debt numbers with practical resolution strategies.

Try it live

POST/numerology/karmic-lessons

Analyze Karmic Lessons - Life lessons from missing numbers

Analyze your Karmic Lessons from your birth name using Pythagorean numerology. Karmic lessons are indicated by numbers missing from your name (numbers 1-9 that do not appear). These represent challenges you came to learn and skills you need to develop in this lifetime. Returns comprehensive analysis including missing numbers, specific lessons for each, challenges to overcome, and practical guidance for development. Perfect for spiritual growth apps, personal development platforms, life coaching services, and self-improvement tools. Get detailed lesson descriptions, development strategies, and practical exercises for each missing number.

Try it live

POST/numerology/bridge

Calculate Bridge Numbers - Harmonize different aspects of personality

Calculate three Bridge Numbers that reveal the adjustments needed to create harmony between different aspects of your numerology profile. Bridge Numbers are the absolute difference between pairs of core numbers: Life Path and Expression, Expression and Personality, Expression and Soul Urge. A Bridge of 0 means the two aspects are already aligned. Higher bridges (1 to 8) indicate greater tension and provide specific guidance on what changes to make. Bridge Numbers are essential for personal development, coaching applications, self-improvement platforms, and AI-powered personality analysis tools. Requires both a full birth name and birth date to calculate all four core numbers (Life Path, Expression, Soul Urge, Personality) internally before deriving the bridges.

Try it live

GET/numerology/compound-number/{number}

Compound number meaning - Cheiro Chaldean interpretation 10 to 52

Get the classical Chaldean interpretation of a compound number (also called a fadic number) from 10 to 52, as defined by Cheiro in the Book of Numbers. Compound numbers are the unreduced two-digit numbers that reveal the hidden influence behind a name or date, beyond the single-digit root. Each returns its symbolic title (such as The Wheel of Fortune for 10, The Star of the Magi for 17, or The Crown of the Magi for 21), its nature (fortunate, unfortunate, or mixed), and a full interpretation. Numbers 33 to 52 share the meaning of a lower number in their series, returned with a sameAs pointer. Perfect for Chaldean numerology references, compound number lookups, and AI numerology tools.

Try it live

Remote MCP for AI agents

Every Numerology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

Claude Code / Cursor

claude mcp add --transport http \
  roxy-numerology https://roxyapi.com/mcp/numerology \
  --header "X-API-Key: YOUR_KEY"

Tool name for POST /numerology/life-path: post_numerology_life_path. Full MCP setup guide

What you can build

AI chatbots and assistants - integrate numerology readings into conversational AI, ChatGPT plugins, and virtual spiritual advisors with structured responses

Dating and relationship apps - add compatibility scoring to matchmaking algorithms, display Life Path synastry on profiles, show partnership potential scores

Personalized wellness platforms - generate automated numerology reports, birth chart PDFs, and daily/yearly guidance for meditation and self-discovery apps

Life coaching and therapy tools - support client sessions with Personal Year forecasts, karmic lesson identification, and life purpose clarity from Life Path analysis

Content generation systems - power horoscope-style content, numerology blog posts, and personalized email campaigns with accurate calculations and rich interpretations

Spiritual marketplaces and consultation services - enable quick numerology readings, tiered report generation (basic to premium), and automated client onboarding with full chart analysis

Drop-in UI components

Render Life Path Number API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

<roxy-numerology-card><roxy-reference-card>

See them live on Roxy UI

Related capabilities

Numerology Compatibility API

All of Numerology API

Life Path Number API FAQ

What does the Life Path Number API return?

Calculate your Life Path number from your birth date using Pythagorean numerology. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

How do I authenticate with the Life Path Number API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

Does the Life Path Number API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

Is the Life Path Number API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/numerology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

How is the Life Path Number API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Life Path Number API is included at no extra cost.

What lang values does the Life Path Number API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

Start using Life Path Number API today.

Ship a numerology app your users will love. This week.

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key