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://api.numerologyapi.com/api/v1/heart_desire`
`POST`	`https://api.numerologyapi.com/api/v1/heart_desire/post`

Required Headers¶

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

You can also authenticate with Authorization: Bearer YOUR_API_KEY.

Create and manage API keys in the Numerology API dashboard.

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").

Add the optional lang query parameter to localize responses. Supported values: en, es, de, fr, pt.

Example Requests¶

GET Request¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/heart_desire?first_name=John&middle_name=Alan&last_name=Doe&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/heart_desire/post?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "first_name": "John",
  "middle_name": "",
  "last_name": "Doe"
}'

Response Example¶

{
  "heart_desire_number": 1,
  "summary": {
    "title": "Heart's Desire / Soul Urge 1: The Drive for Independence & Leadership",
    "overview": "With Soul Urge 1, your deepest inner longing is for freedom, self-determination, and the power to create your own destiny. Your soul yearns to stand out, lead boldly, and express your unique identity without compromise. You are driven by an intense desire to be first, to pioneer, and to achieve things on your own terms.",
    "core_cravings": [
      "To be recognized for your originality and strength",
      "To have complete autonomy over your life path",
      "To initiate and lead rather than follow",
      "To feel powerful, capable, and self-reliant"
    ],
    "emotional_fulfillment": "You feel most alive and satisfied when you are in control of your direction, starting something new, and proving your capabilities. Recognition for your individuality and courage feeds your soul deeply.",
    "shadow_side": [
      "Fear of dependency or being controlled by others",
      "Tendency to become overly self-focused or domineering",
      "Inner frustration when forced to compromise or follow",
      "Loneliness from pushing people away to maintain independence"
    ],
    "healing_growth_path": [
      "Learn that true leadership includes empowering others",
      "Practice receiving help without losing your power",
      "Balance independence with meaningful collaboration",
      "Celebrate your uniqueness while honoring the uniqueness of others"
    ],
    "spiritual_gift": "When balanced, you become an inspiring trailblazer who shows others how to claim their own power with courage and authenticity.",
    "affirmation": "I am whole and powerful in my individuality. I lead with courage and empower others to shine."
  },
  "detailed_meaning": "Heart's Desire Number 1 represents a deep inner longing for independence, leadership, personal achievement, and the freedom to express your individuality authentically. Individuals with Soul Urge 1 yearn to express their unique identity, achieve personal goals independently, and be recognized for their individual accomplishments. At your core, you are driven to take initiative, pioneer new paths, and prove yourself capable of standing alone without relying on others. Your soul craves autonomy, the ability to make your own decisions, and the freedom to pursue your vision without compromise or committee approval. You feel most fulfilled when leading, innovating, creating something original, and being acknowledged as a capable, self-sufficient individual who charts their own course. Deep down, you need to feel special, unique, and significant—not just one of many but someone who stands out and makes their own mark. Relationships and situations that honor your need for independence while allowing you to maintain your distinct identity bring you the deepest soul satisfaction. Challenges include impatience with others' slower pace, difficulty truly collaborating when you prefer solo control, and suppressing your need for recognition to avoid seeming arrogant; learning to lead while empowering others, balancing independence with healthy interdependence, and expressing your need for autonomy without alienating people strengthens your relationships and allows your soul's deepest desires for individual achievement and recognition to manifest in ways that enhance rather than isolate your journey toward the success and acknowledgment your heart truly seeks.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "5531d6cd1002b9d9",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "heart_desire",
    "endpoint_description": "Determines the Heart's Desire (Soul Urge) number, revealing inner motivations and desires.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:29.687243+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

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.

Open Dashboard

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.