Skip to content

title: Personal Week API Endpoint – Weekly Numerology Insights description: Developer documentation for the Personal Week endpoint in The Numerology API: personal week cycle and weekly numerology guidance, request parameter options, authentication, multilingual JSON responses, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).


Personal Week

The Personal Week endpoint returns enterprise numerology output for personal week cycle and weekly numerology guidance. Use this page for integration-ready parameter rules, allowed options, and response examples.

Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/personal-week
POST https://api.numerologyapi.com/api/v1/personal-week

Availability

  • Authentication: X-API-Key (or Authorization: Bearer YOUR_API_KEY)
  • Supported lang values: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
  • Access channel: direct API (https://api.numerologyapi.com)
  • RapidAPI gateway: Not currently supported for extended endpoints

Parameters

GET Query Parameters

Parameter Type Required Default Options Description
dob string Yes — pattern ^\d{4}-\d{2}-\d{2}$ Birthdate in YYYY-MM-DD format
target_date string|null No — pattern ^\d{4}-\d{2}-\d{2}$ Target date in YYYY-MM-DD format
timezone_offset string No Europe/Paris IANA timezone string (example: Europe/Paris) Timezone offset, defaults to Europe/Paris
lang string No en en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh)

POST Query Parameters

Parameter Type Required Default Options Description
lang string No en en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh)

POST Body Parameters

Parameter Type Required Default Options Description
dob string Yes — pattern ^\d{4}-\d{2}-\d{2}$ Date of birth in YYYY-MM-DD format.
target_date string|null No — pattern ^\d{4}-\d{2}-\d{2}$ Target date in YYYY-MM-DD format.
timezone_offset string No Europe/Paris IANA timezone string (example: Europe/Paris) IANA timezone name (for example Europe/Paris).

Response Example

Response Example
{
  "birthdate": "1992-07-16",
  "target_date": "2026-08-17",
  "timezone": "Europe/Paris",
  "week_start": "2026-08-17",
  "week_end": "2026-08-23",
  "iso_week_number": 34,
  "iso_week_year": 2026,
  "personal_week_number": 4,
  "meaning": {
    "title": "Personal Week 4: Order, Discipline & Grounded Progress",
    "overview": "This week brings structure, responsibility, organization, and practical effort. The energy asks you to build on solid foundations rather than chasing quick results. It favors discipline, routine, maintenance, planning, and completion. While it may feel serious compared to lighter weeks, it offers stability, reliability, and tangible progress when you stay focused and consistent.",
    "core_energy": "Grounded • Organized • Disciplined • Reliable • Practical",
    "weekly_theme": "Build what lasts. This week supports consistency, structure, and intentional effort.",
    "energy_manifestation": [
      "A stronger awareness of duties, responsibilities, and unfinished tasks",
      "Need for order, planning, and realistic expectations",
      "Desire to fix, stabilize, and systemize your life or work",
      "Recognition that small disciplined actions create long-term results"
    ],
    "opportunities_this_week": [
      "Create reliable routines that support your future goals",
      "Handle important paperwork, finances, logistics, or home matters",
      "Finish neglected tasks and reduce energetic clutter",
      "Build trust through consistency and integrity"
    ],
    "best_actions": [
      "Plan your days with clarity and realistic priorities",
      "Tidy your environment and strengthen your systems",
      "Focus on completion, not just inspiration",
      "Respect your body, time, and commitments"
    ],
    "watch_out": [
      "Rigidity, pessimism, or being too controlling",
      "Feeling burdened by duties and losing perspective",
      "Perfectionism that slows necessary progress",
      "Ignoring rest while trying to hold everything together"
    ],
    "love_and_relationships": "Love may require maturity, reliability, and practical care this week. If single, you may feel drawn to stability more than fantasy. If partnered, acts of support, responsibility, and follow-through will speak louder than words.",
    "career_and_money": "Excellent for planning, operations, systems, budgeting, technical work, and measurable progress. Financial discipline is favored. This is a good week to review spending habits, build reserves, or create more stable income structures.",
    "spiritual_message": "Discipline is also devotion. What you consistently honor becomes the shape of your life.",
    "spiritual_growth_tip": "Treat your routine as sacred architecture. Build habits that future-you will thank you for.",
    "affirmation": "I build my life with steadiness, discipline, and trust. My consistency creates lasting results."
  },
  "detailed_meaning": "Personal Week 4 grounds you in practicality, discipline, and hard work—calling for focus on health, routines, and foundational tasks. This is not a week for shortcuts; success comes through persistence, organization, and attention to the physical realm. You may feel compelled to clean, repair, budget, or finalize documents; anything requiring sustained effort is favored. Energy levels may feel heavier, so pace yourself to avoid burnout. Challenges may arise from rigidity, frustration with slow progress, or feeling bogged down by responsibilities. The shadow side includes workaholism, stubbornness, or neglecting rest in favor of productivity. To align, create a realistic schedule, prioritize physical well-being, and take pride in the quality of your output. Avoid risky ventures or speculative decisions. When embraced, Personal Week 4 builds stability—proving that consistent effort creates the secure foundation upon which future dreams can rest.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "da30232e7d19dbe8",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "personal_week",
    "endpoint_description": "Computes the Personal Week number to guide weekly energy, focus, and decisions.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-17T17:53:27.692241+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

Open Dashboard


Note

This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.