Skip to content

Weekly Plan API

Generate a structured 7-day plan with training/rest distribution and coaching guardrails.

Endpoint

  • GET /api/v1/fitness/weekly-plan
  • POST /api/v1/fitness/weekly-plan/post

Parameters

Name Type Required In Description
age integer (13-90) Yes Query/Body Age in years.
goal string Yes Query/Body fat_loss,muscle_gain,maintenance,endurance,recomposition.
training_days integer (1-7) Yes Query/Body Weekly training frequency.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Instantly produce a full week training scaffold.
  • Map goal type to workload and recovery pattern.
  • Enable coaching automation with standardized plan blocks.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/weekly-plan?age=31&goal=recomposition&training_days=5&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/weekly-plan/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":38,"goal":"fat_loss","training_days":4}'

Response Example

Info

The response example below is for demonstration purposes only. Make a live request to this endpoint to receive the full, real-time, and potentially richer JSON structure.

{
  "goal": "recomposition",
  "goal_label": "Recomposition",
  "age": 31,
  "training_days": 5,
  "rest_days": 2,
  "weekly_summary": "Balanced split for composition and performance retention.",
  "load_distribution": {"high_days": 2, "moderate_days": 3, "low_or_recovery_days": 2},
  "weekly_schedule": [
    {"day_index": 1, "day_label": "Day 1", "is_training_day": true, "session_focus": "Upper Strength", "intensity": "High", "recovery_block": "Mobility + sleep target"},
    {"day_index": 2, "day_label": "Day 2", "is_training_day": true, "session_focus": "Lower Strength", "intensity": "Moderate", "recovery_block": "Soft tissue + walk"}
  ],
  "execution_guardrails": ["Respect recovery days and trend adherence weekly"],
  "adjustment_signals": ["Reduce intensity if recovery trend declines"],
  "coach_notes": ["Prioritize consistency over maximal daily effort"],
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f4d2bd22d394cc74", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_weekly_plan", "response_language": "en"}
}

Product Positioning

Core endpoint for subscription coaching products and adaptive training platforms.

Note

training_days must be between 1 and 7.