Numerology API
Production-ready Pythagorean numerology API + MCP for AI agents and developers. Calculate life path numbers, destiny numbers, soul urge, relationship compatibility, karmic debt analysis, and complete birth charts. Master number detection (11, 22, 33), karmic lessons, and personal year forecasts. 12+ endpoints with detailed interpretations optimized for chatbots, AI assistants, wellness apps, and spiritual platforms.
Instant API Key Delivery • No Sign-Up Required • Production Ready
Want to get started faster? Check out our free starter apps and templates for complete examples and code you can customize.
Numerology API Features
Calculate Life Path number - Most important numerology calculation
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.
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.
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.
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.
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.
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.
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.
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.
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.
Calculate Compatibility - Relationship dynamics between two people
Calculate numerology compatibility between two people using their Life Path, Expression, and Soul Urge numbers based on Pythagorean numerology. 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.
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.
Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33
Get 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 meanings from authoritative source (Hans Decoz - 50+ years experience).
Production-ready capabilities for your application. Click any feature to view detailed documentation and code examples.
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 endpoint - get all core numbers, karmic analysis, and yearly forecast in single API call for full birth chart reports
Personality and Birth Day numbers - discover outer persona and special gifts from birth day (1-31) for comprehensive profile building
Maturity Number calculation - reveals life purpose emerging around age 35-40 for long-term guidance and soul evolution tracking
Number meanings endpoint - fetch detailed 300-500 word interpretations for any number (1-9, 11, 22, 33) across all contexts
AI-optimized responses - structured JSON with keywords, descriptions, and context perfect for chatbot integration and LLM consumption
Pure mathematics - zero external dependencies, lightning-fast calculations under 20ms, no rate limiting by algorithm complexity
Proven accuracy - follows Hans Decoz methodology with 50+ years validation, used by professional numerologists and spiritual platforms worldwide
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
Getting Started with Numerology API
Start building in under 2 minutes. No signup required.
Next Steps
| Get your API key | View Plans |
| Explore the API | View Docs |
AI-Native Integration
MCPFirst-class Model Context Protocol support for AI agents and autonomous applications
Start Using Numerology API Today
AI-ready Pythagorean numerology calculations for apps and agents
Choose a plan and get your API key instantly delivered to your email. No credit card required for testing. Pay-as-you-go pricing with 12+ endpoints included.
View Pricing & Get API Key