Skip to content

Lucky Days Calendar

The Lucky Days Calendar API provides a detailed personal day-by-day numerology calendar for a chosen period, highlighting your most fortunate days based on your date of birth.
It’s ideal for planning important events, spiritual reflection, and personal productivity.

Discover your lucky days and align your activities with your personal numerology vibration.


Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/lucky-days-calendar
POST https://api.numerologyapi.com/api/v1/lucky-days-calendar

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
dob string Yes Date of birth in YYYY-MM-DD format.
start_date string No Calendar start date in YYYY-MM-DD format. Defaults to today if omitted.
weeks int No Number of weeks to generate (max 12). Default is 9.

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-days-calendar?dob=1992-07-16&start_date=2026-02-27&weeks=9&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/lucky-days-calendar?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16",
  "start_date": "2026-02-27",
  "weeks": 9
}'

Response Example

{
  "dob": "1992-07-16",
  "start_date": "2026-02-27",
  "weeks": 9,
  "total_days": 63,
  "lucky_days": [
    {
      "date": "2026-02-27",
      "day_of_week": "Friday",
      "personal_day_number": 8,
      "meaning": {
        "title": "Personal Day 8: Power, Achievement & Manifestation",
        "overview": "Today carries strong manifesting energy focused on results, power, and material mastery. This is a 'claim your power' day — perfect for advancing goals, handling finances, or stepping into authority. Your ability to create tangible success is heightened.",
        "core_energy": "Powerful • Ambitious • Manifesting • Authoritative • Abundant",
        "opportunities_today": [
          "Advance career, financial, or personal goals",
          "Take on leadership or responsibility",
          "Manifest results through focused action",
          "Reap rewards from previous efforts"
        ],
        "best_actions": [
          "Handle important financial or business matters",
          "Step confidently into your authority",
          "Focus on tangible progress and results",
          "Use power ethically and generously"
        ],
        "watch_out": [
          "Power struggles or control issues",
          "Workaholism and neglecting rest",
          "Equating worth with achievement"
        ],
        "spiritual_growth_tip": "Practice generous giving today. When you circulate power and abundance with wisdom, success becomes truly divine.",
        "affirmation": "I wield power with integrity. Abundance flows through me for the highest good."
      }
    },
    {
      "date": "2026-03-01",
      "day_of_week": "Sunday",
      "personal_day_number": 1,
      "meaning": {
        "title": "Personal Day 1: Initiative, Confidence & Fresh Starts",
        "overview": "Today carries powerful initiating energy — the perfect day to begin new projects, make bold decisions, or assert your independence. Your personal power is amplified; the universe supports courageous first steps and self-directed action. This is a 'planting seeds' day — what you start now carries strong momentum.",
        "core_energy": "Independent • Pioneering • Assertive • Creative ignition",
        "opportunities_today": [
          "Launch personal projects, ideas, or intentions",
          "Take leadership in decisions or conversations",
          "Assert your needs and boundaries clearly",
          "Begin anything that requires courage and self-belief"
        ],
        "best_actions": [
          "Set clear daily intentions for the day/week",
          "Take initiative — make that call, start that task",
          "Dress and act as your most empowered self",
          "Trust your first instincts without overthinking"
        ],
        "watch_out": [
          "Impulsiveness or starting too many things",
          "Ego clashes or dominating others",
          "Impatience with slower-moving people/situations"
        ],
        "spiritual_growth_tip": "Every morning, stand tall and affirm: 'I am the creator of my day.' When you own your power, this day becomes a powerful seed for your future.",
        "affirmation": "I begin with courage and clarity. Today I create my reality boldly."
      }
    },
    ...
    {
      "date": "2026-04-30",
      "day_of_week": "Thursday",
      "personal_day_number": 4,
      "meaning": {
        "title": "Personal Day 4: Discipline, Structure & Practical Focus",
        "overview": "Today brings grounding, productive energy focused on systems, routines, and getting things done. This is a 'build and organize' day — perfect for tackling tasks, creating order, and laying foundations. Steady effort pays off significantly.",
        "core_energy": "Disciplined • Practical • Stable • Methodical • Reliable",
        "opportunities_today": [
          "Organize your space, schedule, or projects",
          "Make progress on long-term goals step by step",
          "Handle practical matters (finances, health routines)",
          "Build or strengthen structures that support you"
        ],
        "best_actions": [
          "Create a clear to-do list and follow it",
          "Tackle tasks you've been avoiding",
          "Focus on quality and thoroughness",
          "Celebrate small wins of completion"
        ],
        "watch_out": [
          "Feeling restricted or frustrated by routine",
          "Overworking or neglecting rest",
          "Resistance to flexibility when needed"
        ],
        "spiritual_growth_tip": "See discipline as devotion. When you build with love and patience, your day becomes sacred foundation work.",
        "affirmation": "I build my day with steady, loving discipline. Every step creates lasting strength."
      }
    }
  ],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "61b24ce9eed29b2c",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "lucky_days_calendar",
    "endpoint_description": "Generates a calendar of personally lucky days based on numerological cycles.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:34.428292+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

  • Lucky days are selected based on numerology numbers 1, 3, 5, 6, 8, 11, 22, 33.
  • Maximum range is 12 weeks. Attempts to request more weeks will return an error.
  • Personal Day Number is calculated from your date of birth and the universal date vibration of each day.
  • Use this calendar for planning key activities, personal growth, and spiritual alignment.