Numerology

Derive core numerology numbers from a name and optional birth date. Costs 2 credits.

POST /v1/numerology

Parameters

Name	Type	Required	Description
`name`	string	Yes	Full name to analyze.
`birthDate`	string	No	Birth date `YYYY-MM-DD`. Enables life path & birth day numbers.

Example request

curl -X POST https://api.gitstrology.dev/v1/numerology \
  -H "X-API-Key: $GITSTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Lovelace",
    "birthDate": "1815-12-10"
  }'

Example response

{
  "data": {
    "input": "Ada Lovelace",
    "lifePath": 9,
    "expression": 7,
    "soulUrge": 5,
    "personality": 2,
    "birthDay": 10,
    "meanings": {
      "lifePath": "The humanitarian — driven by compassion and global vision.",
      "expression": "The seeker — analytical and introspective."
    }
  },
  "credits": { "used": 2, "remaining": 98 }
}

Response fields

Field	Type	Description
`data.input`	string	The name that was analyzed.
`data.lifePath`	number	Life path number (from birth date).
`data.expression`	number	Expression / destiny number (from name).
`data.soulUrge`	number	Soul urge number (vowels in name).
`data.personality`	number	Personality number (consonants in name).
`data.birthDay`	number	Birth day number.
`data.meanings`	object	Map of number name → interpretation string.