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(orAuthorization: Bearer YOUR_API_KEY) - Supported
langvalues:en,es,de,fr,pt - 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, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
POST Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
lang | string | No | en | en, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
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¶
GET¶
{
"birthdate": "1992-07-16",
"target_date": "2026-02-27",
"timezone": "Europe/Paris",
"week_start": "2026-02-23",
"week_end": "2026-03-01",
"iso_week_number": 9,
"iso_week_year": 2026,
"personal_week_number": 6,
"meaning": {
"title": "Personal Week 6: Harmony, Responsibility & Heart-Centered Care",
"overview": "This week emphasizes love, responsibility, healing, home, beauty, and relational balance. Your attention may turn toward family, emotional obligations, caregiving, harmony, or improving the atmosphere around you. The energy supports service, compassion, and restoration. It asks you to nurture what matters while also remembering that care must include yourself, not only others.",
"core_energy": "Nurturing • Responsible • Loving • Balancing • Healing",
"weekly_theme": "What you care for begins to flourish. This week asks for love expressed through presence, responsibility, and meaningful support.",
"energy_manifestation": [
"Greater concern for family, home, love, or emotional wellbeing",
"Desire to create peace, beauty, and emotional order",
"Responsibilities around people who depend on you",
"Heightened awareness of where healing and forgiveness are needed"
],
"opportunities_this_week": [
"Repair a relationship through mature communication and compassion",
"Beautify your environment and raise the quality of your daily life",
"Show up for loved ones in practical and heartfelt ways",
"Balance giving with healthier boundaries and self-respect"
],
"best_actions": [
"Offer support where it is genuinely needed",
"Tend to home, family, and emotional loose ends",
"Create warmth in your environment through beauty and intention",
"Practice care without falling into over-responsibility"
],
"watch_out": [
"Martyrdom, people-pleasing, or carrying what is not yours",
"Overcontrolling loved ones in the name of helping",
"Perfectionism around family, appearance, or emotional harmony",
"Neglecting your own needs while caring for everyone else"
],
"love_and_relationships": "This is a highly relational week for tenderness, commitment, reconciliation, and emotional depth. If single, you may crave something sincere and supportive rather than casual. If partnered, nurturing the bond through quality time and honest care can bring healing.",
"career_and_money": "Good for service-based work, client care, counseling, wellness, hospitality, design, and community-oriented leadership. Financially, spending may lean toward home, family, beauty, or responsibilities. Stay generous but balanced.",
"spiritual_message": "Love becomes sacred when expressed with wisdom, maturity, and clean intention. True care does not require self-abandonment.",
"spiritual_growth_tip": "Ask yourself where you are giving from love and where you are giving from guilt. Strengthen the difference.",
"affirmation": "I create harmony with love, wisdom, and healthy boundaries. I care deeply without losing myself."
},
"detailed_meaning": "Personal Week 6 focuses on responsibility, home, family, and service—calling you to nurture your environment and relationships. This is a time for domestic tasks, caring for loved ones, or resolving interpersonal harmonies. You may feel a strong desire to fix things for others, but ensure you aren't enabling dependency. Beauty, comfort, and aesthetics are highlighted; improving your living space can boost your mood. Challenges may arise from overburdening yourself with others' problems or becoming overly critical of imperfections. The shadow side includes martyrdom, interference, or sacrificing your well-being for the sake of peace. To align, offer help where it is welcomed, set healthy boundaries, and find beauty in ordinary moments. Avoid neglecting your own needs while caring for others. When embraced, Personal Week 6 fosters love and stability—proving that service grounded in respect creates lasting harmony.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "20ef041dd60e06f1",
"quota": "unlimited",
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:37:57.985690+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": ""
}
}
¶
{
"birthdate": "1992-07-16",
"target_date": "2026-02-27",
"timezone": "Europe/Paris",
"week_start": "2026-02-23",
"week_end": "2026-03-01",
"iso_week_number": 9,
"iso_week_year": 2026,
"personal_week_number": 6,
"meaning": {
"title": "Personal Week 6: Harmony, Responsibility & Heart-Centered Care",
"overview": "This week emphasizes love, responsibility, healing, home, beauty, and relational balance. Your attention may turn toward family, emotional obligations, caregiving, harmony, or improving the atmosphere around you. The energy supports service, compassion, and restoration. It asks you to nurture what matters while also remembering that care must include yourself, not only others.",
"core_energy": "Nurturing • Responsible • Loving • Balancing • Healing",
"weekly_theme": "What you care for begins to flourish. This week asks for love expressed through presence, responsibility, and meaningful support.",
"energy_manifestation": [
"Greater concern for family, home, love, or emotional wellbeing",
"Desire to create peace, beauty, and emotional order",
"Responsibilities around people who depend on you",
"Heightened awareness of where healing and forgiveness are needed"
],
"opportunities_this_week": [
"Repair a relationship through mature communication and compassion",
"Beautify your environment and raise the quality of your daily life",
"Show up for loved ones in practical and heartfelt ways",
"Balance giving with healthier boundaries and self-respect"
],
"best_actions": [
"Offer support where it is genuinely needed",
"Tend to home, family, and emotional loose ends",
"Create warmth in your environment through beauty and intention",
"Practice care without falling into over-responsibility"
],
"watch_out": [
"Martyrdom, people-pleasing, or carrying what is not yours",
"Overcontrolling loved ones in the name of helping",
"Perfectionism around family, appearance, or emotional harmony",
"Neglecting your own needs while caring for everyone else"
],
"love_and_relationships": "This is a highly relational week for tenderness, commitment, reconciliation, and emotional depth. If single, you may crave something sincere and supportive rather than casual. If partnered, nurturing the bond through quality time and honest care can bring healing.",
"career_and_money": "Good for service-based work, client care, counseling, wellness, hospitality, design, and community-oriented leadership. Financially, spending may lean toward home, family, beauty, or responsibilities. Stay generous but balanced.",
"spiritual_message": "Love becomes sacred when expressed with wisdom, maturity, and clean intention. True care does not require self-abandonment.",
"spiritual_growth_tip": "Ask yourself where you are giving from love and where you are giving from guilt. Strengthen the difference.",
"affirmation": "I create harmony with love, wisdom, and healthy boundaries. I care deeply without losing myself."
},
"detailed_meaning": "Personal Week 6 focuses on responsibility, home, family, and service—calling you to nurture your environment and relationships. This is a time for domestic tasks, caring for loved ones, or resolving interpersonal harmonies. You may feel a strong desire to fix things for others, but ensure you aren't enabling dependency. Beauty, comfort, and aesthetics are highlighted; improving your living space can boost your mood. Challenges may arise from overburdening yourself with others' problems or becoming overly critical of imperfections. The shadow side includes martyrdom, interference, or sacrificing your well-being for the sake of peace. To align, offer help where it is welcomed, set healthy boundaries, and find beauty in ordinary moments. Avoid neglecting your own needs while caring for others. When embraced, Personal Week 6 fosters love and stability—proving that service grounded in respect creates lasting harmony.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "20ef041dd60e06f1",
"quota": "unlimited",
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:37:57.985690+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": ""
}
}
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.