title: Monthly Energy Heatmap API Endpoint description: Developer documentation for the Monthly Energy Heatmap endpoint in The Numerology API: monthly numerology heatmap and day-by-day energy scoring, 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).
Monthly Energy Heatmap¶
The Monthly Energy Heatmap endpoint returns enterprise numerology output for monthly numerology heatmap and day-by-day energy scoring. Use this page for integration-ready parameter rules, allowed options, and response examples.
Endpoint¶
| Method | Path |
|---|---|
GET | https://api.numerologyapi.com/api/v1/monthly-energy-heatmap |
POST | https://api.numerologyapi.com/api/v1/monthly-energy-heatmap |
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}$ | Date of birth in YYYY-MM-DD format |
month | string | Yes | — | pattern ^\d{4}-\d{2}$ | Target month in YYYY-MM format |
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. |
month | string | Yes | — | pattern ^\d{4}-\d{2}$ | Target month in YYYY-MM format. |
Response Example¶
GET¶
{
"dob": "1992-07-16",
"month": "2026-02",
"monthly_averages": {
"average_day_intensity": 76,
"average_luck": 82,
"average_emotional_load": 40,
"average_money_flow": 72,
"average_stability": 65,
"average_social_flow": 58,
"average_composite_energy": 70
},
"highlights": {
"best_luck_day": {
"date": "2026-02-09",
"score": 98,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
},
"highest_emotional_load_day": {
"date": "2026-02-03",
"score": 60,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
},
"best_money_flow_day": {
"date": "2026-02-05",
"score": 86,
"summary": "Grounding, structure, and practical order day. Useful for practical decisions, resource focus, and material progress."
},
"highest_intensity_day": {
"date": "2026-02-02",
"score": 87,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
}
},
"heatmap_days": [
{
"date": "2026-02-01",
"day_name": "Sunday",
"numbers": {
"life_path_number": 8,
"personal_year_number": 6,
"personal_month_number": 8,
"personal_day_number": 9,
"universal_year_number": 1,
"universal_month_number": 3,
"universal_day_number": 4,
"calendar_day": 1
},
"scores": {
"day_intensity": 71,
"luck": 80,
"emotional_load": 44,
"money_flow": 74,
"stability": 68,
"social_flow": 58,
"composite_energy_score": 69
},
"score_labels": {
"day_intensity": "High",
"luck": "High",
"emotional_load": "Low",
"money_flow": "High",
"stability": "Moderate",
"social_flow": "Moderate",
"composite_energy_score": "Moderate"
},
"dominant_theme": "Opportunity and favorable openings day",
"energy_color_hint": "gold-green",
"summary": "Opportunity and favorable openings day. A balanced approach will help you use the day well.",
"meaning": {
"title": "Moderate Energy Day",
"overview": "This day carries a balanced or mixed energetic profile. It is neither strongly blocked nor strongly amplified, which makes it workable, flexible, and useful for normal responsibilities. Moderate days are often overlooked, but they can be very productive because they reward grounded action rather than emotional overreaction.",
"core_message": "This is a balanced day. It may not carry dramatic momentum, but it can support steady, useful movement.",
"what_this_often_means": [
"The day is generally manageable and functional",
"Some dimensions may be stronger than others, but no single force dominates heavily",
"Practical effort tends to matter more than waiting for a perfect energetic wave",
"This is often a good day for consistency, follow-through, and stable tasks"
],
"best_use_of_the_day": [
"Handle normal priorities with realistic pacing",
"Use the dimension scores to choose the day’s best focus",
"Avoid overcomplicating the day because it feels ordinary",
"Let consistency do the work"
],
"watch_out": [
"Waiting for more energy than the day naturally offers",
"Ignoring the stronger sub-dimensions because the overall score feels average",
"Turning a stable day into a chaotic one through impatience"
],
"guidance": "Moderate days are often ideal for clear, grounded execution. Use what is available instead of demanding dramatic force from the field.",
"affirmation": "I make steady progress through balance, focus, and grounded action."
},
"detailed_meaning": "This day flows with balanced, steady energy that supports sustainable progress, reflection, and integration. The numerological vibration is stable and adaptable, creating space for both action and rest, planning and execution. This is an ideal time for refining strategies, nurturing relationships, and building foundations without the pressure of extreme highs or lows. Expect a manageable pace, clear communication, and opportunities for incremental growth; use this equilibrium to assess your direction, adjust course if needed, and prepare for future intensity. The universe is inviting you to move with rhythm rather than force; honor both productivity and pause, and trust that steady steps create durable outcomes. When honored, this moderate energy becomes a reliable current—proving that consistency, paired with awareness, is the quiet engine of long-term success."
},
...
],
"calendar_notes": {
"description": "A month-wide day-by-day energy map showing intensity, luck, emotional load, money flow, stability, and social flow.",
"difference_from_lucky_days_calendar": "Unlike lucky_days_calendar, this endpoint returns a multidimensional monthly scoring matrix instead of only highlighting favorable dates."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "51d43b4eb6c9a9be",
"quota": "unlimited",
"usage_tracking": true,
"heatmap_planning_api": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"endpoint_name": "monthly_energy_heatmap",
"endpoint_description": "Returns a calendar-like monthly energy heatmap by day intensity, luck, emotional load, money flow, stability, and social flow.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:37:51.922391+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": ""
}
}
¶
{
"dob": "1992-07-16",
"month": "2026-02",
"monthly_averages": {
"average_day_intensity": 76,
"average_luck": 82,
"average_emotional_load": 40,
"average_money_flow": 72,
"average_stability": 65,
"average_social_flow": 58,
"average_composite_energy": 70
},
"highlights": {
"best_luck_day": {
"date": "2026-02-09",
"score": 98,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
},
"highest_emotional_load_day": {
"date": "2026-02-03",
"score": 60,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
},
"best_money_flow_day": {
"date": "2026-02-05",
"score": 86,
"summary": "Grounding, structure, and practical order day. Useful for practical decisions, resource focus, and material progress."
},
"highest_intensity_day": {
"date": "2026-02-02",
"score": 87,
"summary": "Opportunity and favorable openings day. This is a good day to move on opportunities with awareness."
}
},
"heatmap_days": [
{
"date": "2026-02-01",
"day_name": "Sunday",
"numbers": {
"life_path_number": 8,
"personal_year_number": 6,
"personal_month_number": 8,
"personal_day_number": 9,
"universal_year_number": 1,
"universal_month_number": 3,
"universal_day_number": 4,
"calendar_day": 1
},
"scores": {
"day_intensity": 71,
"luck": 80,
"emotional_load": 44,
"money_flow": 74,
"stability": 68,
"social_flow": 58,
"composite_energy_score": 69
},
"score_labels": {
"day_intensity": "High",
"luck": "High",
"emotional_load": "Low",
"money_flow": "High",
"stability": "Moderate",
"social_flow": "Moderate",
"composite_energy_score": "Moderate"
},
"dominant_theme": "Opportunity and favorable openings day",
"energy_color_hint": "gold-green",
"summary": "Opportunity and favorable openings day. A balanced approach will help you use the day well.",
"meaning": {
"title": "Moderate Energy Day",
"overview": "This day carries a balanced or mixed energetic profile. It is neither strongly blocked nor strongly amplified, which makes it workable, flexible, and useful for normal responsibilities. Moderate days are often overlooked, but they can be very productive because they reward grounded action rather than emotional overreaction.",
"core_message": "This is a balanced day. It may not carry dramatic momentum, but it can support steady, useful movement.",
"what_this_often_means": [
"The day is generally manageable and functional",
"Some dimensions may be stronger than others, but no single force dominates heavily",
"Practical effort tends to matter more than waiting for a perfect energetic wave",
"This is often a good day for consistency, follow-through, and stable tasks"
],
"best_use_of_the_day": [
"Handle normal priorities with realistic pacing",
"Use the dimension scores to choose the day’s best focus",
"Avoid overcomplicating the day because it feels ordinary",
"Let consistency do the work"
],
"watch_out": [
"Waiting for more energy than the day naturally offers",
"Ignoring the stronger sub-dimensions because the overall score feels average",
"Turning a stable day into a chaotic one through impatience"
],
"guidance": "Moderate days are often ideal for clear, grounded execution. Use what is available instead of demanding dramatic force from the field.",
"affirmation": "I make steady progress through balance, focus, and grounded action."
},
"detailed_meaning": "This day flows with balanced, steady energy that supports sustainable progress, reflection, and integration. The numerological vibration is stable and adaptable, creating space for both action and rest, planning and execution. This is an ideal time for refining strategies, nurturing relationships, and building foundations without the pressure of extreme highs or lows. Expect a manageable pace, clear communication, and opportunities for incremental growth; use this equilibrium to assess your direction, adjust course if needed, and prepare for future intensity. The universe is inviting you to move with rhythm rather than force; honor both productivity and pause, and trust that steady steps create durable outcomes. When honored, this moderate energy becomes a reliable current—proving that consistency, paired with awareness, is the quiet engine of long-term success."
},
...
],
"calendar_notes": {
"description": "A month-wide day-by-day energy map showing intensity, luck, emotional load, money flow, stability, and social flow.",
"difference_from_lucky_days_calendar": "Unlike lucky_days_calendar, this endpoint returns a multidimensional monthly scoring matrix instead of only highlighting favorable dates."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "51d43b4eb6c9a9be",
"quota": "unlimited",
"usage_tracking": true,
"heatmap_planning_api": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"endpoint_name": "monthly_energy_heatmap",
"endpoint_description": "Returns a calendar-like monthly energy heatmap by day intensity, luck, emotional load, money flow, stability, and social flow.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:37:51.922391+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.