Heart's Desire Number (Soul Urge)¶

The Heart's Desire Number — also known as Soul Urge — is calculated from the vowels in your full birth name. It reveals your inner cravings, deepest motivations, emotional needs, and what truly fulfills your soul.

This number answers:

"What do I really want at the core of my being?"

Endpoint¶

Method	Path
`GET`	`https://the-numerology-api.p.rapidapi.com/heart_desire`
`POST`	`https://the-numerology-api.p.rapidapi.com/heart_desire/post`

Required Headers¶

x-rapidapi-key: YOUR_RAPIDAPI_KEY
x-rapidapi-host: the-numerology-api.p.rapidapi.com
Content-Type: application/json   (POST only)

Get your key from RapidAPI.

Parameters¶

Param	Type	Required	Description
`first_name`	string	Yes	First name (birth certificate spelling).
`middle_name`	string	No	Middle name(s). Include if any.
`last_name`	string	Yes	Last name.

Vowel Rule: Only A, E, I, O, U (and sometimes Y) are counted.
Y is treated as a vowel when it sounds like one (e.g., in "Mary" or "Bryan").

Example Requests¶

GET Request¶

curl --request GET \
  --url "https://the-numerology-api.p.rapidapi.com/heart_desire?first_name=Sarah&middle_name=Jane&last_name=Williams" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

POST Request (JSON Body)¶

curl --request POST \
  --url "https://the-numerology-api.p.rapidapi.com/heart_desire/post" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com" \
  --header "Content-Type: application/json" \
  --data '{
    "first_name": "Michael",
    "middle_name": "David",
    "last_name": "Brown"
  }'

Response Example¶

{
  "heart_desire_number": 6,
  "summary": "The heart's desire number 6 craves love, harmony, and responsibility. You are deeply nurturing, family-oriented, and drawn to creating beauty and balance in relationships.",
  "detailed_meaning": "Number 6 is the nurturer, the healer, the harmonizer. Those with a 6 Heart's Desire feel most fulfilled when caring for others, building loving homes, and fostering peace. They are natural counselors, teachers, and artists who bring beauty into the world. Challenges include over-giving or perfectionism; setting healthy boundaries is essential."
}

Meaning & Interpretation¶

Heart's Desire 6 – The Nurturer & Harmonizer¶

Core Inner Cravings:
- Love, family, and deep emotional connection
- Creating beauty, harmony, and balance
- Helping, healing, and supporting others
- Responsibility and duty to loved ones

What Fulfills You:
- Building a warm, loving home
- Acts of service and caregiving
- Artistic expression (music, design, gardening)
- Being needed and appreciated

Challenges:
- Taking on too much responsibility
- Guilt when saying "no"
- Perfectionism in relationships or home

Advice:
Your soul thrives on love in action. Nurture others — but nurture yourself first. Your gift is creating sanctuary — for yourself and the world.

Master Number Note: Master numbers are reduced to single digit.

View on RapidAPI

Note

Vowel Mapping: A=1, E=5, I=9, O=6, U=3 (Y=7 when vowel-sounding).
Calculation: Sum vowels → reduce to single digit.
Name Accuracy: Use birth name — nicknames alter the soul urge.
Validation: Missing required names → 400.
Use Case: Ideal for relationship compatibility, career counseling, or personal growth.
Caching: 30-day cache on identical names.