NUMEROLOGY
Numerology API: Calculate Life Path & Destiny Numbers
Complete guide to implementing numerology calculations via API with Pythagorean and Chaldean systems.
December 22, 2025
•
11 min read
Core Numerology Numbers
Numerology derives meaning from numbers calculated from names and birth dates. Here are the core calculations:
1
Life Path Number
Calculated from birth date. Your core purpose and life journey.
2
Destiny Number
From full birth name. Your life's goals and potential.
3
Soul Urge
From vowels in name. Your inner desires and motivations.
4
Personality
From consonants. How others perceive you.
API Request
POST https://api.vedika.io/v2/astrology/numerology/complete
{
"fullName": "Rajesh Kumar Sharma",
"dateOfBirth": "1990-05-15",
"system": "pythagorean"
}API Response
{
"name": "Rajesh Kumar Sharma",
"dateOfBirth": "1990-05-15",
"system": "pythagorean",
"coreNumbers": {
"lifePathNumber": {
"value": 3,
"calculation": "1+9+9+0+0+5+1+5 = 30 → 3+0 = 3",
"meaning": "Creative expression, communication, joy",
"strengths": ["Artistic", "Optimistic", "Social"],
"challenges": ["Scattered energy", "Superficiality"]
},
"destinyNumber": {
"value": 7,
"calculation": "R(9)+A(1)+J(1)+E(5)+S(1)+H(8)+K(2)+U(3)+M(4)+A(1)+R(9)+S(1)+H(8)+A(1)+R(9)+M(4)+A(1) = 68 → 6+8 = 14 → 1+4 = 5",
"meaning": "Spiritual seeker, analytical mind",
"strengths": ["Intuitive", "Research-oriented", "Wise"],
"challenges": ["Isolation", "Skepticism"]
},
"soulUrgeNumber": {
"value": 6,
"meaning": "Desire for harmony, family, responsibility",
"vowels": "A-E-U-A-A-A = 1+5+3+1+1+1 = 12 → 3"
},
"personalityNumber": {
"value": 4,
"meaning": "Appears practical, reliable, hardworking",
"consonants": "R-J-S-H-K-M-R-S-H-R-M"
},
"birthdayNumber": {
"value": 15,
"reducedValue": 6,
"meaning": "Magnetic personality, family-oriented"
}
},
"personalYear": {
"year": 2025,
"number": 5,
"theme": "Change, freedom, adventure",
"advice": "Embrace new opportunities and travel"
},
"luckyNumbers": [3, 7, 12, 21, 30],
"luckyDays": ["Wednesday", "Friday"],
"compatibility": {
"mostCompatible": [1, 5, 7],
"challenging": [4, 8]
},
"masterNumbers": {
"hasMasterNumber": false,
"note": "No master numbers (11, 22, 33) in core calculations"
},
"karmicDebt": {
"hasKarmicDebt": false,
"numbers": []
}
}Calculation Systems
Pythagorean System
Sequential assignment: A=1, B=2, C=3...
1
2
3
4
5
6
7
8
9
A
B
C
D
E
F
G
H
I
Chaldean System
Sound-based assignment (no 9 for letters):
1
2
3
4
5
6
7
8
A
B
C
D
E
U
O
F
9 is sacred, not assigned to letters
Python Implementation
import requests
def analyze_numerology(name, dob, system="pythagorean"):
"""Get complete numerology analysis"""
response = requests.post(
"https://api.vedika.io/v2/astrology/numerology/complete",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"fullName": name,
"dateOfBirth": dob,
"system": system
}
)
return response.json()
# Get analysis
result = analyze_numerology("Rajesh Kumar Sharma", "1990-05-15")
# Display core numbers
core = result['coreNumbers']
print(f"Life Path: {core['lifePathNumber']['value']} - {core['lifePathNumber']['meaning']}")
print(f"Destiny: {core['destinyNumber']['value']} - {core['destinyNumber']['meaning']}")
print(f"Soul Urge: {core['soulUrgeNumber']['value']} - {core['soulUrgeNumber']['meaning']}")
# Personal year
py = result['personalYear']
print(f"\n2025 Personal Year: {py['number']} - {py['theme']}")
# Lucky numbers
print(f"Lucky Numbers: {result['luckyNumbers']}")Advanced Features
- Name Compatibility - Compare two names for relationship harmony
- Business Name Analysis - Find lucky business names
- Personal Year/Month/Day - Current numerology cycles
- Master Numbers - Detection of 11, 22, 33
- Karmic Debt Numbers - 13, 14, 16, 19 detection
- Name Suggestions - Generate names with specific numbers
Add Numerology to Your App
Vedika API provides 37 numerology calculations with both Pythagorean and Chaldean systems.
Get API Key