Skip to content

Lucky Numbers

The Lucky Numbers API provides a full numerology profile including key personal numbers derived from your birthdate and full name.
This helps you understand your strengths, opportunities, and spiritual alignment, and plan for success.

Unlock your personal numerology blueprint with a simple API call.

Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/lucky_numbers
POST https://api.numerologyapi.com/api/v1/lucky_numbers/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.

Parameters

Param Type Required Description
birthdate string Yes Your birthdate in YYYY-MM-DD format.
full_name string No Your full name. Some numbers are derived from letters in your name.

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/lucky_numbers?birthdate=1992-07-16&full_name=John+Alan+Doe&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/lucky_numbers/post?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "birthdate": "1992-07-16",
  "full_name": "John Alan Doe"
}'

Response Example

{
  "lucky_numbers": {
    "lucky_number": 8,
    "life_path_number": 8,
    "soul_number": 7,
    "destiny_number": 9,
    "soul_urge_number": 1,
    "inner_dream_number": 8,
    "personal_year": 6,
    "personal_month": 8,
    "personal_day": 9
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "4a39040b7772b8ae",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "lucky_numbers",
    "endpoint_description": "Generates personalized lucky numbers based on numerological calculations.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:33.999125+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": ""
  }
}

Open Dashboard

Note

  • Destiny Number: Your overall life purpose and direction.
  • Life Path Number: Reveals the primary lessons and growth opportunities in your life.
  • Soul Number / Soul Urge Number: Reflects your inner desires, motivations, and emotional needs.
  • Lucky Number: Your general number for prosperity and success.
  • Personal Day / Month / Year: Numerology numbers for daily, monthly, and yearly guidance.
  • Inner Dream Number: Highlights your subconscious goals and ideal achievements.