API reference · v1

Numerology

Full Pythagorean numerology report from a name and birthdate: life path, expression, heart's desire, personality and birth-day numbers with interpretations.

1 endpoints · 1 credit per call
Endpoints

Every numerology endpoint

Parameters, copy-paste examples in three languages, and response shapes.

POST/api/v1/numerology/

Numerology report

Complete numerology report — life path, expression, heart's desire, personality and birth-day numbers with written interpretations.

1 credit per call

Parameters

NameTypeInRequiredDescription
full_namestringbodyrequiredFull birth name
birthdatestringbodyrequiredBirthdate, YYYY-MM-DD

Example request

cURL
curl -X POST "https://api-rho-eight-42.vercel.app/api/v1/numerology/" \
  -H "X-API-Key: kundli_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
  "full_name": "Aarav Sharma",
  "birthdate": "1990-05-15"
}'

Example response

JSON
{
  "full_name": "Aarav Sharma",
  "birthdate": "1990-05-15",
  "life_path": {
    "number": 3,
    "title": "The Creative",
    "interpretation": "..."
  },
  "expression": {
    "number": 8,
    "title": "The Powerhouse",
    "interpretation": "..."
  },
  "heart_desire": {
    "number": 5,
    "title": "The Freedom Seeker",
    "interpretation": "..."
  },
  "personality": {
    "number": 3,
    "title": "The Creative",
    "interpretation": "..."
  },
  "birth_day": {
    "number": 15,
    "title": "The Harmonizer",
    "interpretation": "..."
  }
}

Try it — paste your own key from Developers → API Keys in place of kundli_abc123... and run the snippet against https://api-rho-eight-42.vercel.app.

Need a key?

Create one from your dashboard and paste it into any example above — every snippet is ready to run.