Home › API Docs › Numerology API › Soul Urge

Soul Urge

POST /v1/numerology/soul-urge

**Soul Urge / Heart's Desire Number** Derives the Soul Urge number from the vowels in the full name. This number reveals the innermost desires, motivations, and what the person truly craves at a soul level — the hidden driver behind decisions and relationships. **Required:** dob, name **Optional:** system (chaldean|pythagorean, default chaldean) **Returns:** Soul Urge number, vowels used, ruling planet, gemstone, and bilingual interpretation.

Example request

curl -X POST https://api.grahaapi.com/v1/numerology/soul-urge   -H "Authorization: Bearer sk-test-your-key"   -H "Content-Type: application/json"   -d '{"dob":"1990-05-15","name":"Rahul Sharma","system":"chaldean"}'

Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.

Request fields

FieldTypeRequiredDescription
namestring✅Full name for numerology calculation
dobstring✅Date of birth in YYYY-MM-DD format
systemstring—Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western)

Example body

{
  "dob": "1990-05-15",
  "name": "Rahul Sharma",
  "system": "chaldean"
}

Get a free API key Try it in the playground

Related Numerology endpoints

/v1/numerology/bhagyank · /v1/numerology/bridge-number · /v1/numerology/business-compatibility · /v1/numerology/career · /v1/numerology/challenge-numbers · /v1/numerology/child