Numerology API

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

Life PathNumerology ChartCompatibilityPersonal YearExpression …and so much more

<50mslatency
99.95%+uptime

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.numerology.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

POST /api/v2/numerology/chart
{
  "profile": {
    "name": "John William Smith",
    "birthdate": "1990-07-15"
  },
  "coreNumbers": {
    "lifePath": {
      "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,
      "meaning": {
        "title": "The Adventurer",
        "keywords": [
          "freedom",
          "adventure",
          "change"
        ],
        "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."
      }
    },
    "expression": {
      "number": 6,
      "calculation": "J=1, O=6, H=8, N=5, W=5, I=9, L=3, L=3, I=9, A=1, M=4, S=1, M=4, I=9, T=2, H=8 → 1+6+8+5+5+9+3+3+9+1+4+1+4+9+2+8 = 78 → 15 → 1+5 = 6",
      "type": "single",
      "hasKarmicDebt": false,
      "meaning": {
        "title": "The Nurturer",
        "keywords": [
          "love",
          "harmony",
          "responsibility"
        ],
        "description": "The 6 is the most relationship-oriented of the single-digit numbers, organized around a genuine drive to care for those within its sphere. Its instinct is to tend: to notice when someone needs support and to provide it in ways that are practical and consistent rather than occasional and showy. This quality is not merely sentiment; the 6 experiences the wellbeing of others as intimately connected to its own wellbeing, which gives its caregiving a depth of investment that others rarely match. The 6 is also the most aesthetically attuned of all single-digit numbers, drawn to beauty, harmony, and the creation of environments where people feel at ease. Across numerology traditions, this number is regarded as the most harmonious of the nine: at its best it embodies the mature expression of love as active responsibility rather than passive feeling. Its challenge is learning that care without boundaries depletes rather than sustains.",
        "strengths": [
          "Supportive: The 6 offers support that is attentive and real rather than general and reflexive. It pays close attention to what others actually need, and its response is calibrated to the specific situation rather than a generic expression of concern. This quality makes the 6 one of the most effective caregivers of all numbers: people in its circle know they will receive genuine help rather than symbolic sympathy.",
          "Protective: The 6 is quietly fierce in defense of those it cares for. Its warmth does not preclude assertiveness; when the people or values it holds most closely are at risk, the 6 will respond with a directness that can surprise those who only know its gentler register. The protective instinct of the 6 extends to community and broader social concerns, not only to immediate family.",
          "Responsible: The 6 takes its obligations seriously and follows through on them without requiring external pressure. Whether the commitment is to a family member, a colleague, or a cause, the 6 does what it said it would do, and it does so before the reminder arrives. This quality generates trust that accumulates over time and defines how others understand and rely on this number."
        ],
        "challenges": [
          "Overprotective: The care the 6 offers can tip into control when it becomes convinced that its judgment about what others need is more reliable than their own. This overreach, always well-intentioned, denies others the opportunity to navigate difficulty independently. The 6 genuinely believes it is helping; the difficulty is that its helping sometimes prevents the growth that comes from encountering and resolving one problems independently.",
          "Self-neglecting: The 6 prioritizes others so consistently that its own needs are regularly deferred or ignored entirely. The result is a gradual depletion that the 6 is often slow to recognize, partly because caring for others feels like what it is supposed to be doing. When the depletion becomes severe, the 6 can become resentful or withdrawn, behaviors that seem at odds with its usual warmth but are the predictable consequence of unsustained giving.",
          "Idealistic: The 6 holds a vision of how relationships and communities ought to function, and it can experience significant distress when reality falls consistently short of that vision. This idealism is generative at its best, motivating the 6 to create better environments for those around it. But when it becomes a standard that no real situation can meet, it produces chronic disappointment and a moralizing quality that others find difficult to be around."
        ],
        "career": "The 6 is most effective in roles where its capacity for care and its aesthetic sensibility can both find expression. Healthcare, counseling, teaching, social work, and community organizing fit this number naturally. Its eye for beauty and harmony also serves it in interior design, hospitality, and the arts. The 6 is most fulfilled when it can see a direct connection between its daily work and the wellbeing of the people or environments it serves.",
        "relationships": "The 6 is a devoted and attentive partner who brings warmth, stability, and genuine investment to its closest relationships. Its love is expressed through consistent action rather than declaration. The risk is a tendency to over-function for others while under-attending to its own needs, creating an imbalance that strains the relationship over time. The most successful partnerships for the 6 are those in which mutual care flows in both directions and honesty is valued above surface harmony.",
        "spirituality": "The spiritual life of the 6 is inseparable from its relational life. It finds the sacred in acts of genuine service, in the beauty of natural and created environments, and in the experience of being genuinely connected to another person. Its spiritual lesson is that real service is sustainable only when the 6 first acknowledges its own needs as legitimate. The practice of receiving care with the same openness it extends to others is a significant developmental threshold for this number."
      }
    }
  }
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Drop-in UI components & widgets

Render Numerology 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 Numerology calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Show all Numerology UI components
ElementRenders
<roxy-compatibility-card>Score card with category breakdown
<roxy-numerology-card>Life path, expression, soul urge, personality, personal year, full chart
<roxy-reference-card>Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Challenge life-phase timing, Hidden Passion, Subconscious Self, and Cornerstone and Capstone name analysis. Birth day 1-31 profiles, lucky associations (colors, gemstones, planets), personal year and month forecasts, relationship compatibility, and karmic debt and lessons. Unicode-aware multilingual name handling transliterates Spanish, French, German, Russian, Hindi, Bengali, Tamil, Japanese, Chinese, Korean, Arabic, Greek, and Hebrew names to correct Pythagorean numbers so non-Latin scripts no longer drop letters. Both Pythagorean and Chaldean systems in one call, Cheiro compound numbers (10 to 52) with planetary rulers, and business and brand name analysis. Built for numerology apps, editorial platforms, AI chatbots, and wellness services. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

Every Numerology calculation is covered by 6,044 automated tests per deploy, 1241 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.

Multi-language API responses

EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce

Key Features

Everything you need from our Numerology API, built for production:

Life Path number reveals life purpose and destiny from birth date - detects master numbers 11, 22, 33 and karmic debt 13, 14, 16, 19

Expression (Destiny) and Soul Urge numbers from full birth name - uncover natural talents, inner motivations, and spiritual mission

Relationship compatibility scoring (0-100) - weighted analysis of Life Path, Expression, Soul Urge with strengths, challenges, and advice for couples

Personal Year cycles (1-9) - annual forecasts with themes, opportunities, challenges, and strategic guidance for year-ahead planning

Karmic Lessons analysis - identify missing numbers in birth name revealing underdeveloped traits and growth opportunities

Complete numerology chart - all core numbers, pinnacles, challenges, hidden passion, subconscious self, name analysis, lucky associations, karmic analysis, and yearly forecast in a single API call

Pinnacle and Challenge numbers - four life phases with calculated age ranges, meanings, opportunities, and obstacles for predictive life timeline analysis

Birth Day profiles (1-31) - unique personality, career, and relationship insights per calendar day, not just the reduced single digit

Hidden Passion, Subconscious Self, Cornerstone, Capstone, and First Vowel analysis - deep name letter profiling for editorial-grade readings

Lucky associations per Life Path - colors, gemstones, ruling planet, element, compatible and incompatible numbers for personalized lifestyle content

Personal Year, Month, and Day forecasts - annual, monthly, and daily personalized themes and guidance for year-ahead, month-ahead, and daily planning

Bridge Numbers - reveal the gap between Life Path and Expression, Expression and Personality, Expression and Soul Urge with actionable advice for harmonizing different aspects of self

Maturity Number with activation status - reveals emerging life purpose around age 35-40, accepts raw name and birthdate or pre-calculated numbers

Compatibility accepts raw name and birthdate inputs - no pre-calculation needed, supports mixed mode (numbers for one person, raw inputs for the other)

Number meanings endpoint - fetch detailed 300-500 word interpretations for any number (1-9, 11, 22, 33) across all contexts

Pure mathematics - zero external dependencies, lightning-fast calculations under 20ms, no rate limiting by algorithm complexity

Proven accuracy - verified against authoritative Pythagorean numerology standards with step-by-step calculation strings for full transparency

Global name input support - Spanish, French, German, Italian, Portuguese, Russian, Ukrainian, Belarusian, Hindi, Bengali, Tamil, Japanese (Hiragana and Katakana), Chinese, Korean, Arabic, Greek, Hebrew names automatically transliterated to Latin for correct Pythagorean number computation, so José Garcia, Анна, राज, 김민준, and 王明 all produce the same accurate output as their plain ASCII equivalents

Chaldean numerology system - the older 1 to 8 letter method (the number 9 is never assigned to a letter) returning Destiny, Soul Urge, and Personality numbers with planetary rulers and a caution flag for the karmic numbers 4 and 8

Cheiro compound numbers (10 to 52) - the unreduced fadic numbers that reveal the hidden influence behind a name, each with its classical symbol (the Wheel of Fortune, the Crown of the Magi) and full interpretation from the Book of Numbers

Dual-system readings in one call - Pythagorean and Chaldean name numbers side by side with an agreement flag, the only numerology API that returns both systems in a single request

Business and brand name numerology - Chaldean name number, planetary ruler, business rating, industry fit, and favorable-compound check for vetting company and product names

All Endpoints

Click any endpoint to view detailed documentation, parameters, and response examples.

Calculate Life Path number - Most important numerology calculationCalculate Life Path number - Most important numerology calculationCalculate 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.Try it
Calculate Expression number - Natural talents and life goalsCalculate Expression number - Natural talents and life goalsCalculate 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
Calculate Bridge Numbers - Harmonize different aspects of personalityCalculate Bridge Numbers - Harmonize different aspects of personalityCalculate 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
Calculate Soul Urge number - Inner motivations and desiresCalculate Soul Urge number - Inner motivations and desiresCalculate 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
Calculate Personality number - How others perceive youCalculate Personality number - How others perceive youCalculate 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
Calculate Birth Day number - Special talents from day of birthCalculate Birth Day number - Special talents from day of birthCalculate 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
Calculate Maturity number - Who you become in later lifeCalculate Maturity number - Who you become in later lifeCalculate 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
Analyze Karmic Lessons - Life lessons from missing numbersAnalyze Karmic Lessons - Life lessons from missing numbersAnalyze 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
Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)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
Calculate Personal Day - Daily personalized numerology forecastCalculate your Personal Day number from birth month, day, and a target date. Personal Day is the most granular cycle in Pythagorean numerology, revealing the specific energy and theme for a single calendar day personalized to you. Unlike generic daily numbers, this is based on YOUR birth data combined with the calendar date. Returns the daily theme, actionable guidance, and parent month and year context. Perfect for daily push notifications, morning briefings, calendar widget integrations, daily content generation, and life coaching tools.Calculate Personal Month - Monthly numerology forecastCalculate your Personal Month number from birth month, day, and a target year and month. Personal Month reveals the specific theme and energy influencing each calendar month within your Personal Year cycle. Returns the monthly theme, practical focus guidance, and the parent Personal Year context. Perfect for monthly forecast features, push notification content, calendar integrations, editorial monthly columns, and life coaching tools.
Calculate Personal Year - Annual cycle and forecast for current yearCalculate Personal Year - Annual cycle and forecast for current yearCalculate 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
Show all endpoints
Calculate Compatibility - Relationship dynamics between two peopleCalculate Compatibility - Relationship dynamics between two peopleCalculate numerology compatibility between two people using Pythagorean numerology. Accepts two input modes per person: pre-calculated Life Path, Expression, and Soul Urge numbers, or raw name and birthdate for automatic calculation. You can mix modes across persons (e.g. numbers for person1, raw inputs for person2). Provides comprehensive relationship analysis with overall compatibility score (0-100), individual aspect compatibility (Life Path 50% weight, Expression 30%, Soul Urge 20%), relationship strengths, challenges, and practical advice. Uses detailed compatibility matrix for all number combinations. Perfect for dating apps, relationship counseling platforms, matchmaking services, and compatibility tools. Get actionable insights for improving relationship dynamics.Try it
Generate Complete Numerology Chart - Full profile analysisGenerate Complete Numerology Chart - Full profile analysisGenerate 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
Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33Get the complete meaning and interpretation for any numerology number (1-9, 11, 22, 33) using Pythagorean numerology. Returns comprehensive description including archetype title, keywords, personality traits, strengths, weaknesses, career guidance, relationship dynamics, and spiritual insights. Master numbers (11, 22, 33) include amplified meanings with their reduced base number. Perfect for numerology reference tools, educational apps, quick lookups, and building custom numerology calculators. Get detailed 300-500 word expert-written meanings for all 12 valid numerology numbers.Get daily numerology number - Number of the Day with interpretationReceive a daily numerology number (1-9, 11, 22, 33) for guidance and reflection. Uses seeded randomness so the same seed gets the same number on the same date, perfect for "Number of the Day" features in numerology apps, wellness platforms, and daily guidance tools. Returns the number with full interpretation including archetype, keywords, strengths, challenges, career, relationships, and spiritual insights. Ideal for daily push notifications, morning briefings, and personalized numerology experiences.Chaldean numerology name reading - Destiny, compound number, planetary rulerCalculate a complete Chaldean numerology reading for a name. The older Chaldean system maps letters to values 1 to 8 by vibration (the number 9 is sacred and never assigned to a letter) and reads the unreduced two-digit compound number (10 to 52, also called a fadic number, defined by Cheiro) in addition to the single-digit root. Returns the Destiny or name number from all letters, the Soul Urge from vowels, and the Personality from consonants, each with its compound number, root, and Cheiro compound interpretation, plus the planetary ruler of the Destiny root and a caution flag for the karmic numbers 4 and 8. Perfect for Chaldean numerology calculators, name analysis tools, and AI numerology assistants that need both the compound and root layers in one call.
Compound number meaning - Cheiro Chaldean interpretation 10 to 52Compound number meaning - Cheiro Chaldean interpretation 10 to 52Get 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
Dual numerology - Pythagorean and Chaldean name numbers in one callCalculate a name number in both major numerology systems at once and compare them. The Pythagorean system maps letters 1 to 9 in alphabetical order and preserves master numbers (11, 22, 33), giving the Expression or Destiny number used in modern Western numerology. The Chaldean system maps letters 1 to 8 by vibration, reads the compound number (10 to 52), and reduces to a root 1 to 9. Returns both results with their interpretations, plus an agreement flag showing whether the two systems point to the same single-digit energy. The only numerology API that returns Pythagorean and Chaldean for a name in a single request, ideal for comparison tools and AI numerology assistants.Business name numerology - Chaldean brand name analysis and lucky numbersAnalyze a business or brand name with Chaldean numerology, the system practitioners use for trade names. Returns the name number (compound and root), its planetary ruler, an overall business rating, the industries the number favors, and whether the compound is one of Cheiro fortunate compounds. The most favorable business roots are 1 (leadership), 3 (expansion), 5 (commerce) and 6 (beauty and hospitality); the numbers 4 and 8 carry caution as the karmic numbers of instability and heavy demand. Use it to vet a company name, compare brand options, or guide a naming decision. This is positioning guidance layered over the fundamentals of a memorable, available name, not a guarantee.

Free Templates for Numerology

Clone. Edit. Ship. Free and open source by Team Roxy.

Browse all templates or use AI prompts to generate a custom app.

What You Can Build with Numerology API

Real-world applications and use cases for integrating Numerology API into your projects:

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

Business and brand naming tools - vet company and product names with Chaldean numerology, surface lucky numbers by industry, and compare name options before launch

What developers are saying

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback

Do not take our word for it. Ask the agents.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Opens a live web search in a new tab.

Getting started with Numerology API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • Token-optimized responses — opt-in compact mode returns the same data with each field name sent once, cutting the tokens your agent reads per call by roughly 40 to 52 percent. Lossless, and one call still counts as one request.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.

From your AI agent to a verified Numerology answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris6,044 tests, 1241 vs NASA JPL
Verified result12 domains, one flat rate

Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.

Audit it yourself: every Numerology endpoint runs live in the API playground

Numerology API FAQ

How do I calculate a Life Path number from a birth date?

Send a birth date to the numerology API and you get the Life Path number back with a step-by-step calculation and a full written meaning. It uses the Pythagorean system, preserves master numbers, and flags karmic debt automatically. No birth time and no location are needed, so this is the single easiest spiritual reading to integrate. Your RoxyAPI key activates instantly and unlocks Life Path alongside 11 other domains, all on one flat plan.

How do I get an Expression or Destiny number from a name?

Pass a full birth name and the numerology API returns the Expression number, also called the Destiny number, which maps every letter to reveal natural talents and life direction. Names in Latin and non-Latin scripts are handled, so accented and global names compute correctly. Drop it in with our typed SDKs for TypeScript, Python, PHP, C#, and Go, the WordPress plugin, or our Remote MCP server, with no local setup and no Docker. One key, instant activation, and the same name powers Soul Urge and Personality too.

What does the Soul Urge number reveal and how is it calculated?

The Soul Urge number, drawn from the vowels in a full birth name, reveals what a person truly wants underneath the surface. The numerology API returns it with a clear interpretation built for self-discovery, dating, and coaching products. Request Soul Urge on its own, or get it together with Life Path, Expression, Personality, Birthday, and Maturity in one full chart call. Responses are structured JSON, so they are easy to render in an app or hand straight to an AI agent.

Does the numerology API support master numbers and karmic debt?

Yes. Master numbers 11, 22, and 33 are kept intact instead of being reduced, and each comes with its own dedicated interpretation. Karmic debt numbers 13, 14, 16, and 19 are detected during the calculation and returned with their meanings. This depth ships across every reading, from a single Life Path call to the full chart with pinnacles, challenges, karmic lessons, and hidden passion. The math is transparent: every result includes the reduction steps so you can show your work.

How do I add a Personal Year forecast to my app?

Send a birth month and day with a target year and the numerology API returns the Personal Year cycle from 1 to 9, with its theme, keywords, and practical advice. Companion monthly and daily forecasts break the same energy into tighter guidance for planners and content automation. It is a natural fit for year-ahead emails, coaching check-ins, and daily insight feeds. Interpretations come in 8 languages through a single query parameter, professionally localized for each locale.

Can the numerology API score compatibility between two people?

Yes. Give it two people, as either raw names and birth dates or pre-calculated numbers, and the numerology API returns a 0 to 100 compatibility score with shared strengths, challenges, and advice. You can mix the modes, so one partner can be a name and the other a number. Because numerology needs no birth time or coordinates, this is one of the fastest matchmaking features to ship into a dating or relationship product. It is also exposed as a tool on our Remote MCP server for AI agents and through llms.txt for AI search.

What is the difference between Pythagorean and Chaldean numerology?

Pythagorean numerology maps letters 1 to 9 in alphabetical order and keeps the master numbers 11, 22, and 33. Chaldean numerology, the older system, maps letters 1 to 8 by vibration, never assigns 9 to a letter, and reads the unreduced compound number alongside the single-digit root. The numerology API returns both. Call the dual endpoint to get a name in both systems at once, with an agreement flag that shows whether they point to the same energy.

Does the numerology API support Chaldean numerology and compound numbers?

Yes. The Chaldean endpoint returns the Destiny, Soul Urge, and Personality numbers using the Chaldean letter values, each with its compound number, root, and planetary ruler. Compound numbers from 10 to 52, also called fadic numbers, carry the classical Cheiro interpretations such as the Wheel of Fortune and the Crown of the Magi. You can also look up any compound number directly, and analyze a business or brand name with the same Chaldean method.

Start using Numerology 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