Life Path Number API
Calculator and meaning API
Included with every plan (at no extra cost)
Calculate a Life Path number from a birth date with Pythagorean numerology. The Life Path is the core number of a numerology chart, read from the birth year, month and day alone, with master numbers 11, 22 and 33 kept and a karmic debt of 13, 14, 16 or 19 flagged with its meaning. The response returns every reduction step and a full interpretation (archetype title, keywords, description, strengths, challenges, career, relationships and spirituality) in the language set by lang. Built for Life Path calculators, numerology apps, onboarding personality profiles and AI agents.
Request
POST /api/v2/numerology/life-path
Parameters
| Parameter | Type | Description |
|---|---|---|
| langquery | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns 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
{
"year": 1990,
"month": 7,
"day": 15
}Response
Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
{
"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": true,
"karmicDebtNumber": 14,
"karmicDebtMeaning": {
"description": "Accumulated Obligation of Moderation and Stability",
"challenge": "A past pattern of misusing personal freedom, whether through overindulgence, excess, or the manipulation of others. In this lifetime, the pressure toward instability, overindulgence, or avoidance of commitment tends to recur. The challenge is building the capacity for sustained dedication without overcompensating into rigidity.",
"resolution": "Develop moderation as a practiced discipline rather than a reactive restriction. Build and honor commitments in measured increments. Learn to exercise freedom within a structure of genuine responsibility rather than in defiance of it. The balance is an earned quality, not a natural one."
},
"meaning": {
"title": "The Adventurer",
"keywords": [
"freedom",
"adventure",
"change",
"versatility",
"curiosity",
"adaptability",
"independence",
"variety",
"resourcefulness",
"exploration"
],
"description": "The 5 is the most kinetic of all single-digit numbers. It is in constant motion, oriented toward what is new, and constitutionally resistant to the kind of settled routine that other numbers find stabilizing. Occupying the center of the 1-through-9 sequence, the 5 functions as a pivot point: it has engaged with enough of life to know that many directions are possible, and its primary drive is to explore as many of them as it can. This number is defined by versatility and adaptability; it adjusts to new circumstances not through effort but through a genuine responsiveness to its environment that makes transitions feel natural. The freedom the 5 requires is not simply physical; it is cognitive and relational as well. It needs room to form its own opinions, change them without pressure, and pursue experience without being constrained by convention. At its most developed, the 5 harnesses its wide-ranging engagement with life into wisdom that only direct experience can produce.",
"strengths": [
"Adaptable: The 5 adjusts to new conditions with a fluidity that most other numbers find difficult to achieve. Changes of environment, circumstance, or direction that would unsettle a 4 or frustrate a 6 are absorbed by the 5 with minimal disruption. This adaptability is not indifference; it reflects a genuine curiosity about what each new situation contains. The 5 treats transition as information rather than threat.",
"Resourceful: When conventional approaches do not serve, the 5 draws on a broad repertoire of experience to find an alternative. Its exposure to varied people, environments, and situations gives it a practical creativity that is grounded in what has actually worked rather than in theory. The 5 does not wait for ideal conditions; it works with what is available and finds a way through.",
"Socially fluent: The 5 moves easily across different social contexts, adapting its communication style to connect with a wide range of people. This social fluency reflects a genuine interest in others and an ability to find common ground across significant differences. The 5 is often the person who can build a bridge between groups that have difficulty understanding each other."
],
"challenges": [
"Unreliable: The same mobility that makes the 5 effective can make it difficult to count on. Its attention shifts with genuine speed, and commitments made during a period of enthusiasm may not survive the arrival of something more immediately compelling. This inconsistency is rarely malicious, but it produces real costs in professional relationships and personal ones where others have organized their expectations around the word of the 5.",
"Impulsive: The preference for direct experience over careful planning means the 5 often acts before considering consequences. This impulsiveness generates interesting experiences and occasionally stumbles into the right answer, but it also produces avoidable difficulties that a modest investment in forethought would have prevented. The 5 does not naturally slow down to evaluate; it moves first and recalibrates afterward.",
"Directionless: The abundance of interests available to the 5 can produce a life that is wide but not deep. Without a chosen direction to organize its energy, the 5 may move through many experiences without accumulating the competence and mastery that comes from sustained engagement with a single domain. The result can be a restlessness that never quite resolves into genuine fulfillment."
],
"career": "The 5 requires variety, autonomy, and stimulation in its professional life. Sales, journalism, public relations, travel-related work, entrepreneurship, and roles requiring frequent contact with new people and situations suit this number well. It performs poorly under rigid management structures or in repetitive environments where each day resembles the last. The 5 often changes career directions multiple times before finding a role that offers the scope it requires, and the experience gained along the way is rarely wasted.",
"relationships": "The 5 brings vitality and spontaneity to relationships but requires genuine freedom within them to function well. It is more loyal than it initially appears: once genuinely committed, it maintains that commitment. The difficulty arises in reaching that commitment, as the 5 resists anything that feels like confinement. Partners who respect its independence and bring their own richness to the relationship tend to hold the attention of the 5 most durably. A relationship that claims the 5 must earn it.",
"spirituality": "The 5 encounters the sacred primarily through direct experience rather than formal practice. Travel, conversation with diverse people, and immersion in unfamiliar environments are all forms of spiritual inquiry for this number. Its lesson is that genuine freedom is not the absence of commitment but the presence of a chosen direction. The 5 develops spiritually when it learns to distinguish restlessness from growth, and when it recognizes that depth and freedom are not opposites."
}
}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 | Every step of the calculation: the birth month, day and year each reduced, then combined 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 | Defining personality traits and energetic themes of this number. Useful for quick personality snapshots, tag clouds and compatibility matching. |
| meaning.description* | string | Core interpretation of the number covering personality, purpose and life themes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full-page reading. |
| 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 fieldsShow fewer 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
Call it in your language.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
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
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
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 -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.
Calculate Expression number - Destiny number calculator API
Calculate the Expression number, also called the Destiny number, from a full birth name with Pythagorean numerology. Every letter is valued and the name is reduced name by name, with master numbers 11, 22 and 33 kept and a karmic debt of 13, 14, 16 or 19 flagged with its meaning. The response lists every letter value and returns a full interpretation of natural talents, career, relationships and spiritual path in the language set by lang. Built for name numerology apps, career and personal brand tools, and AI agents.
Try it liveCalculate Personal Year - Personal Year number forecast API
Calculate the Personal Year number from a birth month and day with Pythagorean numerology, the 1 to 9 cycle that sets the theme of a calendar year. The year is the one sent, or the current UTC year when omitted, and it turns over on 1 January; the birth year is not needed. The response returns the place in the nine-year cycle, the theme, a forecast, opportunities, challenges and advice in the language set by lang. Built for yearly planning features, New Year content, coaching tools and AI agents.
Try it liveGenerate numerology chart - Complete numerology reading API
Generate a complete numerology chart from a full birth name and birth date in one call. It returns the six core numbers (Life Path, Expression, Soul Urge, Personality, Birth Day and Maturity) with their calculations and full interpretations, the four Pinnacles and four Challenges with their ages, Karmic Lessons, karmic debt in all five positions, Hidden Passion, Subconscious Self, Cornerstone, Capstone and First Vowel, the Birth Day profile for the exact day, lucky associations, the Maturity activation status, the Personal Year with the current Personal Month, and a written summary, in the language set by lang. The Personal Year uses currentYear or the current UTC year, while the Personal Month and the age behind the Maturity status read the current UTC date. Built for full numerology readings, PDF reports, onboarding profiles and AI agents.
Try it liveCalculate Soul Urge number - Heart Desire number calculator API
Calculate the Soul Urge number, also called the Heart Desire number, from the vowels of a full birth name with Pythagorean numerology. A, E, I, O and U are the vowels and Y and W count as consonants; master numbers 11, 22 and 33 are kept and a karmic debt of 13, 14, 16 or 19 is flagged with its meaning. The response lists every vowel name by name and returns a full interpretation of inner motivation, relationships and spiritual path in the language set by lang. Built for self-discovery apps, dating profiles, coaching tools and AI agents.
Try it liveCalculate Personality number - Outer personality numerology API
Calculate the Personality number from the consonants of a full birth name with Pythagorean numerology. Every letter other than A, E, I, O and U is a consonant, Y and W included; master numbers 11, 22 and 33 are kept and a karmic debt of 13, 14, 16 or 19 is flagged with its meaning. The response lists every consonant name by name and returns a full interpretation of first impressions, public image, career and relationships in the language set by lang. Built for personal branding apps, social and dating profiles, coaching tools and AI agents.
Try it liveCalculate Birth Day number - Birthday numerology API
Calculate the Birth Day number from the day of the month a person was born, 1 to 31, with Pythagorean numerology. The 11th, 22nd and 29th keep the master numbers 11 and 22, other two-digit days reduce to one digit, and the 13th, 14th, 16th and 19th are flagged as karmic debt with their meaning. The response returns the calculation and a full interpretation of the special talents the day brings in the language set by lang. Built for birthday features, talent and career discovery tools, and AI agents.
Try it liveCalculate Maturity number - Realization number numerology API
Calculate the Maturity number, also called the Realization number, from the Life Path and Expression numbers with Pythagorean numerology. Send a full birth name and birth date, the two numbers precomputed, or one of each; master numbers 11, 22 and 33 are kept at full value and in the result. The Maturity number describes who a person grows into in the second half of life, usually felt from around 35 to 40, and the response returns the calculation and a full interpretation in the language set by lang. Built for life coaching apps, midlife and later-life guidance, and AI agents.
Try it liveDetect Karmic Debt numbers - Karmic debt 13, 14, 16, 19 API
Detect Karmic Debt numbers 13, 14, 16 and 19 across the five core numbers that carry them: Life Path, Expression, Soul Urge, Personality and Birth Day. Send a birth date, a full birth name, or both, and only the positions those inputs reach are read; each debt is listed once with its challenge and resolution guidance in the language set by lang. Built for spiritual growth apps, karmic readings, coaching tools and AI agents.
Try it liveAnalyze Karmic Lessons - Missing numbers numerology API
Analyze the Karmic Lessons of a full birth name with Pythagorean numerology: the numbers 1 to 9 that no letter of the name carries. Each missing number is returned with its lesson, a fuller explanation and practical guidance for developing it, in the language set by lang, beside the count of letters behind every number present. Built for spiritual growth apps, coaching tools, full numerology reports and AI agents.
Try it liveCalculate Bridge Numbers - Numerology bridge numbers API
Calculate four numerology Bridge numbers from a full birth name and birth date: Life Path and Expression, Expression and Soul Urge, Soul Urge and Personality, and Expression and Personality. Each bridge is the distance between two core numbers, from 0 to 8, where 0 means the two are already in harmony, and comes with guidance for closing the gap in the language set by lang. Built for personal development, coaching and personality analysis tools and AI agents.
Try it liveGet compound number meaning - Chaldean compound numbers 10 to 52 API
Get the classical Chaldean meaning of a compound number, also called a fadic number, from 10 to 52 as Cheiro defines it. A compound number is the unreduced two-digit total behind a name or date, read beside its single-digit root. The response returns the root, the nature (fortunate, unfortunate or mixed), the full interpretation in the language set by lang, and the symbolic name where Cheiro gives one, such as The Wheel of Fortune for 10 or The Crown of the Magi for 21; a number from 33 up that repeats a lower one carries a sameAs pointer to it. Built for Chaldean numerology references, name analysis tools and AI agents.
Try it liveRemote 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 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
Numerology apps and calculators: Life Path pages, full chart readings and name analysis from one integration
Dating and relationship apps: compatibility scores on profiles, Life Path matching and partnership advice from names and birth dates
AI chatbots and agents: structured numerology readings an assistant can quote, with every calculation step to show its work
Wellness and self-discovery platforms: personalized reports, Personal Year planning and daily Personal Day guidance
Editorial and content teams: yearly, monthly and daily numerology columns and personalized email campaigns
Business and brand naming tools: vet company and product names with Chaldean numerology and compare options before launch
Drop-in UI components and no-code widgets.
Render Life Path Number API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Life Path Number API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
Show all Life Path Number UI componentsShow fewer Life Path Number UI components
| Element | Renders |
|---|---|
| <roxy-numerology-card> | Life path, expression, soul urge, personality, personal year, full chart |
| <roxy-compound-number> | Compound 10 to 52 with name, root, nature and meaning |
Related capabilities
Life Path Number API FAQ
What does the Life Path Number API return?
Calculate a Life Path number from a birth date with 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 18 domains, so the Life Path Number API is included at no extra cost.
Start using Life Path Number API today.
Life Path, Destiny and Chaldean numerology that shows every step, checked against the authors who defined it.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key


