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/v1/numerology/analyze

{
  "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/v1/numerology/analyze",
        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 Free API Key