Numerology API reference

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}'

{
  "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...",
    "resolution": "Develop moderation as a practiced discipline rather than a reactive restriction. Build and honor..."
  },
  "meaning": {
    "title": "The Adventurer",
    "keywords": [
      "freedom",
      "adventure"
    ],
    "description": "The 5 is the most kinetic of all single-digit numbers. It is in constant motion, oriented toward...",
    "strengths": [
      "Adaptable",
      "Resourceful"
    ],
    "challenges": [
      "Unreliable",
      "Impulsive"
    ],
    "career": "The 5 requires variety, autonomy, and stimulation in its professional life. Sales, journalism...",
    "relationships": "The 5 brings vitality and spontaneity to relationships but requires genuine freedom within them to...",
    "spirituality": "The 5 encounters the sacred primarily through direct experience rather than formal practice...."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/expression" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"John William Smith"}'

{
  "number": 6,
  "calculation": "John: J=1, O=6, H=8, N=5 = 20 → 2; William: W=5, I=9, L=3, L=3, I=9, A=1, M=4 = 34 → 7; Smith: S=1, M=4, I=9, T=2, H=8 = 24 → 6 → 2+7+6 = 15 → 6",
  "type": "single",
  "hasKarmicDebt": false,
  "karmicDebtNumber": 14,
  "karmicDebtMeaning": {
    "description": "Accumulated Obligation of Moderation and Stability",
    "challenge": "A past pattern of misusing personal freedom, whether through overindulgence, excess, or the...",
    "resolution": "Develop moderation as a practiced discipline rather than a reactive restriction. Build and honor..."
  },
  "meaning": {
    "title": "The Nurturer",
    "keywords": [
      "love",
      "harmony"
    ],
    "description": "The 6 is the most relationship-oriented of the single-digit numbers, organized around a genuine...",
    "strengths": [
      "Supportive",
      "Protective"
    ],
    "challenges": [
      "Overprotective",
      "Self-neglecting"
    ],
    "career": "The 6 is most effective in roles where its capacity for care and its aesthetic sensibility can both...",
    "relationships": "The 6 is a devoted and attentive partner who brings warmth, stability, and genuine investment to...",
    "spirituality": "The spiritual life of the 6 is inseparable from its relational life. It finds the sacred in acts of..."
  }
}

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

{
  "lifePathExpression": {
    "bridge": 3,
    "from": {
      "name": "Life Path",
      "number": 5
    },
    "to": {
      "name": "Expression",
      "number": 8
    },
    "meaning": "Focus on developing self-discipline and a consistent work ethic. Channel your creative ideas into structured plans with clear milestones. Regular routines and organized habits will help you align your inner vision with your outer expression."
  },
  "expressionPersonality": {
    "bridge": 3,
    "from": {
      "name": "Life Path",
      "number": 5
    },
    "to": {
      "name": "Expression",
      "number": 8
    },
    "meaning": "Focus on developing self-discipline and a consistent work ethic. Channel your creative ideas into structured plans with clear milestones. Regular routines and organized habits will help you align your inner vision with your outer expression."
  },
  "soulUrgePersonality": {
    "bridge": 3,
    "from": {
      "name": "Life Path",
      "number": 5
    },
    "to": {
      "name": "Expression",
      "number": 8
    },
    "meaning": "Focus on developing self-discipline and a consistent work ethic. Channel your creative ideas into structured plans with clear milestones. Regular routines and organized habits will help you align your inner vision with your outer expression."
  },
  "expressionSoulUrge": {
    "bridge": 3,
    "from": {
      "name": "Life Path",
      "number": 5
    },
    "to": {
      "name": "Expression",
      "number": 8
    },
    "meaning": "Focus on developing self-discipline and a consistent work ethic. Channel your creative ideas into structured plans with clear milestones. Regular routines and organized habits will help you align your inner vision with your outer expression."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/soul-urge" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"John William Smith"}'

{
  "number": 7,
  "calculation": "Vowels: John: O=6 = 6; William: I=9, I=9, A=1 = 19 → 10 → 1; Smith: I=9 = 9 → 6+1+9 = 16 → 7",
  "type": "single",
  "hasKarmicDebt": true,
  "karmicDebtNumber": 16,
  "karmicDebtMeaning": {
    "description": "Accumulated Obligation of Humility and Authentic Love",
    "challenge": "A past pattern centered on ego, misuse of relational power, or the destruction of bonds through...",
    "resolution": "Develop authentic humility by setting aside the need for status in close relationships. Build..."
  },
  "meaning": {
    "title": "The Seeker",
    "keywords": [
      "wisdom",
      "introspection"
    ],
    "description": "The 7 is the most internally-oriented of the single-digit numbers. While other numbers are engaged...",
    "strengths": [
      "Analytical",
      "Spiritually perceptive"
    ],
    "challenges": [
      "Withdrawn",
      "Overly private"
    ],
    "career": "The 7 performs at its highest level in roles that reward solitary investigation, analytical depth...",
    "relationships": "The 7 forms relationships with care and some difficulty, opening its interior world slowly and only...",
    "spirituality": "The 7 is the most naturally spiritual of the single-digit numbers, not in a doctrinal sense but in..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/personality" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"John William Smith"}'

{
  "number": 8,
  "calculation": "Consonants: John: J=1, H=8, N=5 = 14 → 5; William: W=5, L=3, L=3, M=4 = 15 → 6; Smith: S=1, M=4, T=2, H=8 = 15 → 6 → 5+6+6 = 17 → 8",
  "type": "single",
  "hasKarmicDebt": false,
  "karmicDebtNumber": 16,
  "karmicDebtMeaning": {
    "description": "Accumulated Obligation of Humility and Authentic Love",
    "challenge": "A past pattern centered on ego, misuse of relational power, or the destruction of bonds through...",
    "resolution": "Develop authentic humility by setting aside the need for status in close relationships. Build..."
  },
  "meaning": {
    "title": "The Powerhouse",
    "keywords": [
      "achievement",
      "authority"
    ],
    "description": "The 8 is the number most directly associated with material mastery and the exercise of authority in...",
    "strengths": [
      "Ambitious",
      "Resilient"
    ],
    "challenges": [
      "Controlling",
      "Status-oriented"
    ],
    "career": "The 8 is drawn to professional domains where strategic intelligence and organizational capability...",
    "relationships": "The 8 is loyal and reliable in close relationships, and it expresses care primarily through...",
    "spirituality": "The spiritual path of the 8 runs through its engagement with material life rather than away from..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/birth-day" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"day":23}'

{
  "number": 5,
  "calculation": "23 → 5",
  "type": "single",
  "hasKarmicDebt": false,
  "karmicDebtNumber": 19,
  "karmicDebtMeaning": {
    "description": "Karmic Debt of Power Abuse",
    "challenge": "Past life misuse of power or authority, possibly selfishness.",
    "resolution": "Learn to use power wisely and share it with others."
  },
  "meaning": {
    "title": "The Adventurer",
    "keywords": [
      "versatile",
      "adaptable"
    ],
    "description": "People born on a 5 Birth Day have natural versatility and adaptability...",
    "strengths": [
      "Adaptability",
      "Communication"
    ],
    "challenges": [
      "Restlessness",
      "Scattered energy"
    ],
    "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..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/maturity" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lifePath":5,"expression":7,"fullName":"John William Smith","year":1990}'

{
  "number": 3,
  "calculation": "Life Path 5 + Expression 7 = 12 → 3",
  "type": "single",
  "hasKarmicDebt": false,
  "karmicDebtNumber": 14,
  "karmicDebtMeaning": {
    "description": "Karmic Debt of Abuse of Freedom",
    "challenge": "Past life misuse of personal freedom, possibly through excess or manipulation.",
    "resolution": "Learn balance, moderation, and responsible use of freedom."
  },
  "meaning": {
    "title": "The Communicator",
    "keywords": [
      "expressive",
      "creative"
    ],
    "description": "People with a 3 Maturity number grow into creative and joyful expression...",
    "strengths": [
      "Creative expression",
      "Communication"
    ],
    "challenges": [
      "Scattered energy",
      "Superficiality"
    ],
    "career": "Life Path 3 thrives in creative fields where self-expression and communication take center stage...",
    "relationships": "Life Path 3 individuals are charming, playful, and expressive partners...",
    "spirituality": "Three vibrates with the energy of the Divine Child: playful, imaginative, and endlessly curious..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/karmic-lessons" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"John William Smith"}'

{
  "missingNumbers": [
    2,
    4
  ],
  "lessons": [
    {
      "number": 2,
      "lesson": "Learn cooperation, patience, and sensitivity",
      "description": "Missing number 2 indicates challenges with teamwork and relationships...",
      "howToOvercome": "Practice active listening, work on group projects, develop empathy..."
    }
  ],
  "presentNumbers": {
    "1": 3,
    "3": 2,
    "5": 4,
    "6": 1,
    "7": 2,
    "9": 2
  }
}

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

{
  "hasKarmicDebt": true,
  "debtNumbers": [
    14,
    16
  ],
  "meanings": [
    {
      "number": 14,
      "description": "Karmic Debt of Abuse of Freedom",
      "challenge": "Past life misuse of personal freedom through excess or manipulation...",
      "resolution": "Learn balance, moderation, and responsible use of freedom..."
    }
  ],
  "message": "Karmic debt is present in the core numbers: 14, 16. Each of these represents a concentrated area of unresolved experience carried from prior incarnations, requiring deliberate attention and sustained work in this lifetime to move through."
}

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

{
  "personalDay": 7,
  "theme": "Rest and Reflection",
  "guidance": "Step back from external demands and go inward. Reflect, meditate, study, or simply rest.",
  "targetDate": "2026-04-04",
  "personalMonth": 3,
  "personalMonthTheme": "Creative Expression",
  "personalYear": 8,
  "personalYearTheme": "Power and Achievement"
}

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

{
  "personalMonth": 3,
  "theme": "Creative Expression",
  "focus": "Express yourself creatively, socialize, and communicate. Writing, art, and public speaking are favored.",
  "calendarMonth": 4,
  "personalYear": 8,
  "personalYearTheme": "Power and Achievement"
}

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

{
  "personalYear": 5,
  "cycle": "Year 5 of 9",
  "theme": "Freedom and Change",
  "forecast": "This is a year of freedom, change, and unexpected opportunities. You will feel restless and eager for new experiences...",
  "opportunities": [
    "Travel and adventure",
    "Career changes"
  ],
  "challenges": [
    "Restlessness",
    "Scattered energy"
  ],
  "advice": "Embrace change and new experiences but maintain some stability. Stay flexible and open-minded..."
}

curl -X POST "https://roxyapi.com/api/v2/numerology/compatibility" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"fullName":"John William Smith","year":1990,"month":7,"day":15,"lifePath":5,"expression":7,"soulUrge":6},"person2":{"fullName":"Jane Marie Doe","year":1992,"month":3,"day":22,"lifePath":3,"expression":9,"soulUrge":2}}'

{
  "overallScore": 78,
  "rating": "Very Compatible",
  "lifePath": {
    "person1": 5,
    "person2": 3,
    "compatibility": 85,
    "description": "5 and 3 create an exciting dynamic partnership..."
  },
  "expression": {
    "person1": 7,
    "person2": 9,
    "compatibility": 70,
    "description": "7 and 9 share spiritual depth..."
  },
  "soulUrge": {
    "person1": 6,
    "person2": 2,
    "compatibility": 90,
    "description": "6 and 2 have complementary emotional needs..."
  },
  "strengths": [
    "Complementary personalities",
    "Shared values"
  ],
  "challenges": [
    "Different communication styles",
    "Need for independence vs togetherness"
  ],
  "advice": "This relationship thrives on mutual respect and space for individual growth. Focus on..."
}

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

{
  "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"
        ],
        "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...",
        "strengths": [
          "Adaptable: The 5 adjusts to new conditions with a fluidity that most other numbers find difficult to achieve...",
          "Resourceful: When conventional approaches do not serve, the 5 draws on a broad repertoire of experience to find an alternative..."
        ],
        "challenges": [
          "Unreliable: The same mobility that makes the 5 effective can make it difficult to count on...",
          "Impulsive: The preference for direct experience over careful planning means the 5 often acts before considering consequences..."
        ],
        "career": "The 5 requires variety, autonomy, and stimulation in its professional life. Sales, journalism, public relations, travel-related work, entrepreneurship...",
        "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...",
        "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..."
      }
    },
    "expression": {
      "number": 6,
      "calculation": "John: J=1, O=6, H=8, N=5 = 20 → 2; William: W=5, I=9, L=3, L=3, I=9, A=1, M=4 = 34 → 7; Smith: S=1, M=4, I=9, T=2, H=8 = 24 → 6 → 2+7+6 = 15 → 6",
      "type": "single",
      "hasKarmicDebt": false,
      "karmicDebtNumber": 16,
      "meaning": {
        "title": "The Nurturer",
        "keywords": [
          "love",
          "harmony"
        ],
        "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...",
        "strengths": [
          "Supportive: The 6 offers support that is attentive and real rather than general and reflexive...",
          "Protective: The 6 is quietly fierce in defense of those it cares for..."
        ],
        "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...",
          "Self-neglecting: The 6 prioritizes others so consistently that its own needs are regularly deferred or ignored entirely..."
        ],
        "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...",
        "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...",
        "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..."
      }
    },
    "soulUrge": {
      "number": 7,
      "calculation": "Vowels: John: O=6 = 6; William: I=9, I=9, A=1 = 19 → 10 → 1; Smith: I=9 = 9 → 6+1+9 = 16 → 7",
      "type": "single",
      "hasKarmicDebt": true,
      "karmicDebtNumber": 16,
      "meaning": {
        "title": "The Seeker",
        "keywords": [
          "wisdom",
          "introspection"
        ],
        "description": "The 7 is the most internally-oriented of the single-digit numbers. While other numbers are engaged primarily with the external world of action, relationship, and material achievement, the 7 is fundamentally concerned with the interior world of understanding...",
        "strengths": [
          "Analytical: The 7 is skilled at separating what is essential from what is incidental, and at identifying patterns that others overlook...",
          "Spiritually perceptive: The 7 has access to intuitive knowledge that supplements and sometimes outpaces its logical reasoning..."
        ],
        "challenges": [
          "Withdrawn: The 7 spends much of its mental life in internal territory, and this can produce a social distance...",
          "Overly private: The 7 holds its interior world closely and is reluctant to share what it thinks and feels..."
        ],
        "career": "The 7 performs at its highest level in roles that reward solitary investigation, analytical depth, and the pursuit of non-obvious insight. Research science, philosophy, data analysis, writing, psychology, and investigative fields of all kinds draw on the best qualities of this number...",
        "relationships": "The 7 forms relationships with care and some difficulty, opening its interior world slowly and only to those who have demonstrated patience and genuine interest...",
        "spirituality": "The 7 is the most naturally spiritual of the single-digit numbers, not in a doctrinal sense but in its persistent orientation toward what lies beneath surface experience..."
      }
    },
    "personality": {
      "number": 8,
      "calculation": "Consonants: John: J=1, H=8, N=5 = 14 → 5; William: W=5, L=3, L=3, M=4 = 15 → 6; Smith: S=1, M=4, T=2, H=8 = 15 → 6 → 5+6+6 = 17 → 8",
      "type": "single",
      "hasKarmicDebt": false,
      "karmicDebtNumber": 19,
      "meaning": {
        "title": "The Powerhouse",
        "keywords": [
          "achievement",
          "authority"
        ],
        "description": "The 8 is the number most directly associated with material mastery and the exercise of authority in the world. It is oriented toward achievement, and it brings to that orientation an uncommon combination of strategic intelligence, organizational capability, and physical endurance...",
        "strengths": [
          "Ambitious: The 8 sets high targets and organizes its resources around reaching them...",
          "Resilient: The 8 does not interpret setback as failure..."
        ],
        "challenges": [
          "Controlling: The 8 has strong convictions about how things should be managed and can find it genuinely difficult to delegate...",
          "Status-oriented: The 8 can become overly invested in the visible markers of success: titles, possessions, and professional recognition..."
        ],
        "career": "The 8 is drawn to professional domains where strategic intelligence and organizational capability produce measurable results. Corporate leadership, finance, real estate, law, and high-level management suit it well...",
        "relationships": "The 8 is loyal and reliable in close relationships, and it expresses care primarily through provision and practical support rather than through emotional expressiveness...",
        "spirituality": "The spiritual path of the 8 runs through its engagement with material life rather than away from it. Its core lesson concerns the relationship between power and integrity..."
      }
    },
    "birthDay": {
      "number": 6,
      "calculation": "15 → 6",
      "type": "single",
      "hasKarmicDebt": false,
      "karmicDebtNumber": 13,
      "meaning": {
        "title": "The Nurturer",
        "keywords": [
          "compassion",
          "healing"
        ],
        "description": "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...",
        "strengths": [
          "Supportive: It pays close attention to what others actually need, and its response is calibrated to the specific situation...",
          "Protective: 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..."
        ],
        "challenges": [
          "Overprotective: This overreach, always well-intentioned, denies others the opportunity to navigate difficulty independently...",
          "Self-neglecting: The result is a gradual depletion that the 6 is often slow to recognize..."
        ],
        "career": "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 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...",
        "spirituality": "Its spiritual lesson is that real service is sustainable only when the 6 first acknowledges its own needs as legitimate..."
      }
    },
    "maturity": {
      "number": 11,
      "calculation": "Life Path 5 + Expression 6 = 11",
      "type": "single",
      "hasKarmicDebt": false,
      "karmicDebtNumber": 14,
      "meaning": {
        "title": "The Master Intuitive",
        "keywords": [
          "intuition",
          "spiritual sensitivity"
        ],
        "description": "Eleven operates on a fundamentally different frequency than the single-digit numbers. The foundation of 2 is present: the need to relate, to listen, to balance, to work alongside others. But 11 adds a perceptive capacity that transcends ordinary observation...",
        "strengths": [
          "Perceptive depth: The capacity to read a situation, a person, or a group dynamic at a level that exceeds what is visible on the surface...",
          "Inspirational presence: Eleven draws people toward it without calculated effort..."
        ],
        "challenges": [
          "Perceptual overload: Harsh environments, interpersonal conflict, and sustained criticism land harder than they would for most numbers...",
          "Chronic self-doubt: The gap between what 11 perceives and what it can prove rationally generates ongoing uncertainty..."
        ],
        "career": "Eleven is most effective in roles where insight and sensitivity are the primary instrument rather than a liability to be managed. Counseling, therapeutic practice, spiritual direction, and teaching are natural alignments...",
        "relationships": "Eleven brings unusual attentiveness to partnership. It registers the emotional undercurrents of a relationship with precision, which can be an extraordinary quality and an occasional source of friction...",
        "spirituality": "The spiritual dimension of 11 is inseparable from its everyday functioning. The perceptive quality that appears in a counseling session or a difficult conversation is what contemplative traditions call spiritual receptivity..."
      }
    }
  },
  "additionalInsights": {
    "karmicLessons": {
      "missingNumbers": [
        7
      ],
      "lessons": [
        {
          "number": 7,
          "lesson": "Develop inner life, reflective depth, and trust in introspective knowledge",
          "description": "Absence of the number 7 indicates an underdeveloped inner life and a tendency to remain on the surface of experience without deeper reflection...",
          "howToOvercome": "Develop a regular practice of reflection, whether through writing, meditation, study, or deliberate time in solitude..."
        }
      ],
      "presentNumbers": {
        "1": 3,
        "3": 2,
        "5": 4,
        "6": 1,
        "7": 2,
        "9": 2
      }
    },
    "karmicDebt": {
      "hasKarmicDebt": true,
      "debtNumbers": [
        14
      ],
      "meanings": [
        {
          "number": 14,
          "description": "Accumulated Obligation of Moderation and Stability",
          "challenge": "A past pattern of misusing personal freedom, whether through overindulgence, excess, or the manipulation of others...",
          "resolution": "Develop moderation as a practiced discipline rather than a reactive restriction. Build and honor commitments in measured increments..."
        }
      ]
    },
    "personalYear": {
      "personalYear": 4,
      "cycle": "Year 4 of 9",
      "theme": "Work and Foundation",
      "forecast": "The Personal Year 4 introduces the most demanding work period of the cycle. After three years of initiation, cooperation, and expression, the numerological current now insists on structure, discipline, and the unglamorous labor of building something durable...",
      "opportunities": [
        "Building durable professional and personal foundations that will last",
        "Establishing effective systems and routines that reduce friction over time"
      ],
      "challenges": [
        "Feelings of restriction and limited freedom of movement under the slower energy",
        "Frustration with the pace of visible results in methodical, long-horizon work"
      ],
      "advice": "Commit to the unglamorous work of building. Systems, routines, and disciplined follow-through are not merely means to an end this year. Do not mistake slowness for failure...",
      "personalMonth": {
        "personalMonth": 3,
        "theme": "Expression and Connection",
        "focus": "Creative and communicative work finds its best conditions. Reach out to people, put ideas into visible form, and allow social engagement to open professional doors that direct effort cannot."
      }
    },
    "pinnacles": [
      {
        "position": 1,
        "number": 4,
        "startAge": 0,
        "endAge": 31,
        "meaning": {
          "title": "Foundation Building and Disciplined Effort",
          "description": "A Pinnacle under the number 4 centers on the construction of durable foundations: in career, finances, living conditions, and the structure of daily life...",
          "opportunities": [
            "Establishing stable career foundations, acquiring property, or building financial structures with long-term durability",
            "Developing sophisticated organizational habits and planning systems that improve across the entire phase"
          ],
          "challenges": [
            "Feeling confined or depleted by the demands of sustained routine over an extended period",
            "Rigidity in method and resistance to modifying approaches even when circumstances shift"
          ]
        }
      }
    ],
    "challenges": [
      {
        "position": 1,
        "number": 1,
        "startAge": 0,
        "endAge": 31,
        "meaning": {
          "title": "The Independence Challenge",
          "description": "The 1 Challenge calls for the sustained development of genuine self-reliance. Life repeatedly constructs situations in which the individual must choose between standing on personal judgment and deferring to the expectations or authority of others...",
          "lesson": "Developing authentic self-reliance and the confidence to act from personal conviction rather than either external permission or reactive defiance.",
          "howToOvercome": "Begin with smaller decisions made entirely independently, then build toward larger ones. Resist the pattern of seeking approval before acting..."
        }
      }
    ],
    "hiddenPassion": {
      "number": 1,
      "count": 3,
      "allPassions": [
        1,
        9
      ],
      "title": "Compulsion Toward Leadership",
      "description": "The number 1 appearing most often in a name produces a persistent need for originality and self-direction. This person feels most fully expressed when operating independently and setting direction for others..."
    },
    "subconsciousSelf": {
      "number": 8,
      "uniqueNumbers": [
        1,
        2
      ],
      "title": "Near-Complete Resourcefulness",
      "description": "With 8 of 9 number values present, almost no situation triggers the feeling of being unprepared. A vast experiential base is available to draw on in difficulty..."
    },
    "nameLetters": {
      "cornerstone": {
        "letter": "J",
        "number": 1,
        "meaning": "The approach to new beginnings is direct and self-directed. The default instinct is to take initiative rather than wait for consensus, to assess a situation independently, and to engage on personal terms."
      },
      "capstone": {
        "letter": "N",
        "number": 5,
        "meaning": "Endings are handled quickly and without extended backward glance. Protracted closing phases generate impatience, and a clean break is consistently preferred over gradual transition."
      },
      "firstVowel": {
        "letter": "O",
        "meaning": "The instinctive emotional response is principled and measured. Reactions are filtered through a sense of what is right and appropriate before full expression occurs."
      }
    }
  },
  "birthDayProfile": {
    "day": 15,
    "reducesTo": 6,
    "title": "The Magnetic Artist",
    "keywords": [
      "magnetism",
      "artistic sensibility"
    ],
    "description": "The 15th combines the forward drive of 1, the versatility and appetite for experience of 5, and the care-centered orientation of the reduced 6. The result is one of the more immediately compelling birth day numbers...",
    "strengths": [
      "Personal magnetism that creates immediate and lasting impressions",
      "Genuine facility with language and visual aesthetic expression"
    ],
    "challenges": [
      "Stubbornness that continues past the point where flexibility would be more useful",
      "Susceptibility to emotional overwhelm when carrying the burdens of others"
    ],
    "career": "Healthcare, counseling, social work, teaching, and any direct-service role align with their nurturing orientation and practical capability. Their artistic inclinations open additional paths in visual arts, design, photography, and creative direction...",
    "relationships": "Those born on the 15th offer devoted, attentive partnership that combines emotional warmth with practical support. They are drawn to partners who are genuinely engaged in their own lives and purposes..."
  },
  "maturityStatus": {
    "isActive": true,
    "currentAge": 36,
    "activationRange": "35-40"
  },
  "luckyAssociations": {
    "colors": [
      "Green",
      "Turquoise"
    ],
    "gemstones": [
      "Emerald",
      "Aquamarine"
    ],
    "day": "Wednesday",
    "element": "Air",
    "rulingPlanet": "Mercury",
    "compatibleNumbers": [
      1,
      3
    ],
    "incompatibleNumbers": [
      2,
      4
    ]
  },
  "summary": "Your numerology chart reveals a Life Path 5 personality seeking freedom and adventure..."
}

curl "https://roxyapi.com/api/v2/numerology/meanings/5" \
  -H "X-API-Key: YOUR_KEY"

{
  "number": 5,
  "type": "single",
  "meaning": {
    "title": "The Adventurer",
    "keywords": [
      "freedom",
      "adventure"
    ],
    "description": "In the span of single-digit numbers 1 to 9, 5 is the number in the exact middle...",
    "strengths": [
      "Curious",
      "Adaptable"
    ],
    "challenges": [
      "Non-committal",
      "Unreliable"
    ],
    "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..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/daily" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"user123","date":"2026-03-06"}'

{
  "date": "2026-03-06",
  "seed": "user123-2026-03-06",
  "number": 7,
  "type": "single",
  "dailyMessage": "Your number for 2026-03-06 is 7 (The Seeker). Focus on introspection, analysis, and spiritual growth today.",
  "meaning": {
    "title": "The Seeker",
    "keywords": [
      "analytical",
      "spiritual"
    ],
    "description": "The 7 is the most internally-oriented of the single-digit numbers. While other numbers are engaged primarily with the external world of action, relationship, and material achievement, the 7 is fundamentally concerned with the interior world of understanding...",
    "strengths": [
      "Analytical: The 7 is skilled at separating what is essential from what is incidental, and at identifying patterns that others overlook...",
      "Spiritually perceptive: The 7 has access to intuitive knowledge that supplements and sometimes outpaces its logical reasoning..."
    ],
    "challenges": [
      "Withdrawn: The 7 spends much of its mental life in internal territory, and this can produce a social distance...",
      "Overly private: The 7 holds its interior world closely and is reluctant to share what it thinks and feels..."
    ],
    "career": "The 7 performs at its highest level in roles that reward solitary investigation, analytical depth, and the pursuit of non-obvious insight. Research science, philosophy, data analysis, writing, psychology, and investigative fields of all kinds draw on the best qualities of this number...",
    "relationships": "The 7 forms relationships with care and some difficulty, opening its interior world slowly and only to those who have demonstrated patience and genuine interest...",
    "spirituality": "The 7 is the most naturally spiritual of the single-digit numbers, not in a doctrinal sense but in its persistent orientation toward what lies beneath surface experience..."
  }
}

curl -X POST "https://roxyapi.com/api/v2/numerology/chaldean" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Helen"}'

{
  "name": "Helen",
  "destiny": {
    "total": 23,
    "compound": 23,
    "root": 5,
    "calculation": "H=5, E=5, L=3, E=5, N=5 = 23 → 5"
  },
  "soulUrge": {
    "total": 23,
    "compound": 23,
    "root": 5,
    "calculation": "H=5, E=5, L=3, E=5, N=5 = 23 → 5"
  },
  "personality": {
    "total": 23,
    "compound": 23,
    "root": 5,
    "calculation": "H=5, E=5, L=3, E=5, N=5 = 23 → 5"
  },
  "numberMeaning": {
    "number": 5,
    "planet": "Mercury",
    "title": "The Communicator",
    "keywords": [
      "versatility",
      "communication"
    ],
    "caution": false,
    "meaning": "Ruled by Mercury. Mercurial, adaptable and clever, the 5 thrives on trade, travel and communication."
  },
  "caution": false,
  "summary": "The name Helen carries a Chaldean Destiny root of 5 (The Communicator), ruled by Mercury, with a compound number of 23."
}

curl "https://roxyapi.com/api/v2/numerology/compound-number/23" \
  -H "X-API-Key: YOUR_KEY"

{
  "number": 23,
  "name": "The Royal Star of the Lion",
  "nature": "fortunate",
  "meaning": "A promise of success, help from superiors and protection from those in high places.",
  "root": 5,
  "sameAs": 24
}

curl -X POST "https://roxyapi.com/api/v2/numerology/dual" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"David"}'

{
  "name": "David",
  "pythagorean": {
    "number": 22,
    "type": "master",
    "calculation": "D=4, A=1, V=4, I=9, D=4 → 4+1+4+9+4 = 22",
    "title": "The Master Builder",
    "keywords": [
      "master builder",
      "manifestation"
    ]
  },
  "chaldean": {
    "compound": 16,
    "root": 7,
    "total": 16,
    "calculation": "D=4, A=1, V=6, I=1, D=4 = 16 → 7",
    "planet": "Neptune",
    "title": "The Seeker",
    "caution": false
  },
  "agreement": false,
  "note": "The two systems diverge for this name: Pythagorean points to 22 while Chaldean points to 7."
}

curl -X POST "https://roxyapi.com/api/v2/numerology/business-name" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ford"}'

{
  "name": "Ford",
  "total": 21,
  "compound": 21,
  "root": 3,
  "planet": "Jupiter",
  "rating": "excellent",
  "favorableCompound": true,
  "industries": [
    "Media and content",
    "Education and training"
  ],
  "guidance": "An expansive vibration ruled by Jupiter. Excellent for growth, communication and creativity, favoring brands built on expertise, advice and reputation.",
  "calculation": "F=8, O=7, R=2, D=4 = 21 → 3",
  "summary": "Ford has a Chaldean business root of 3 (excellent). An expansive vibration ruled by Jupiter. Excellent for growth, communication and creativity, favoring brands built on expertise, advice and reputation."
}