Skip to content

Minor Heart's Desire Number

The Minor Heart's Desire Number is calculated from the vowels in your short name (first + last). It reveals your deepest inner craving — what your soul truly wants at its core.

This is the most intimate layer of your emotional self.

No Master Numbers: Always reduced to a single digit (1–9).


Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/minor-heart-desire
POST https://api.numerologyapi.com/api/v1/minor-heart-desire

Note: POST uses same path as GET — no /post suffix.


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
short_name string Yes Full short name (e.g., "Emma Brown").

Only one field: short_name — must contain at least one vowel.


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/minor-heart-desire?short_name=John+Doe&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/minor-heart-desire?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "short_name": "John Doe"
}'

Response Example

{
  "short_name": "John Doe",
  "minor_heart_desire_number": 8,
  "keyword": "The Empowered Magnate",
  "meaning": "You crave power, success, and material mastery. Your soul’s deepest longing is to achieve, influence, and build legacies that demonstrate your competence, authority, and ability to shape reality through disciplined action and strategic vision.",
  "detailed_meaning": "Your inner fire burns with the desire to succeed—not just for wealth, but for the deep satisfaction of knowing your efforts create tangible results that endure and empower others long after you’re gone. You long to command respect through competence, wield influence ethically, and build empires—whether businesses, institutions, or systems—that reflect your vision, values, and unwavering commitment to excellence. This craving for mastery isn’t greed—it’s a sacred alignment with the truth that abundance is a tool for service, and that your soul thrives when your power is used to uplift, not dominate, the collective. However, this deep yearning may manifest as workaholism that sacrifices health or relationships, equating self-worth with status, or the shadow belief that control is the only path to security and success. Karmically, your soul is learning that true power includes generosity—that legacy is measured not just in assets accumulated, but in lives empowered, and that influence without integrity is hollow and short-lived. Your greatest fulfillment arises when your success becomes a platform for others—when your resources, networks, and authority are used to open doors, fund causes, and mentor the next generation of leaders. Guard against burnout by practicing generous delegation—empower others to rise alongside you, knowing that the strongest empires are built not by one, but by many united in a shared vision of what’s possible. When honored fully, your Minor Heart’s Desire 8 becomes a forge of principled legacy—proving that the deepest success isn’t taken, but responsibly created through vision, effort, and the unwavering belief that heaven blesses those who build wisely, give generously, and lead with integrity.",
  "vibration": "Your inner fire burns for authority, abundance, and impact.",
  "note": "Derived from vowels only. This is your soul's deepest craving.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "45f23b366a5a3abc",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "minor_heart_desire",
    "endpoint_description": "Determines the Minor Heart Desire from vowels in current name.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:36.002555+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

Minor Heart's Desire 3 – The Joyful Creator

Deepest Craving:
- Creative self-expression
- Joy, laughter, and play
- Being seen and celebrated
- Uplifting others

Soul Statement:

"I am fulfilled when I create and bring happiness."

Best Outlets:
- Art, writing, music, comedy, teaching, hosting

Challenges:
- Fear of criticism
- Scattering energy
- Avoiding depth

Advice:
Your soul needs joy in action. Create freely. Your gift is spreading light — let it shine.


Open Dashboard


Note

  • Input: short_name only (e.g., "John Doe").
  • Vowels Only: A, E, I, O, U (Y excluded).
  • Calculation: Sum vowel values → reduce to single digit only (1–9).
  • No Master Numbers: Always reduced.
  • Validation:
  • Missing short_name400
  • No vowels → 400
  • Use Case: Soul-level coaching, emotional healing, spiritual growth.
  • Caching: 30-day cache on identical short_name.