Skip to content

Progression Targets API

Generate phased progression schedule for fat loss, gain, maintenance, endurance, or recomposition goals.

Endpoint

  • GET /api/v1/fitness/progression-targets
  • POST /api/v1/fitness/progression-targets/post

Parameters

Name Type Required In Description
goal string Yes Query/Body fat_loss,muscle_gain,maintenance,endurance,recomposition.
current_weight number (35-300) Yes Query/Body Current body weight in kg.
time_horizon_weeks integer (2-52) Yes Query/Body Target timeline in weeks.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Build realistic weekly targets from safe progression logic.
  • Return min/max safety bounds for risk control.
  • Power check-in workflows with clear course-correction rules.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/progression-targets?goal=recomposition&current_weight=82&time_horizon_weeks=12&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/progression-targets/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"goal":"fat_loss","current_weight":91,"time_horizon_weeks":16}'

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",
  "current_weight_kg": 82.0,
  "time_horizon_weeks": 12,
  "weekly_target_change_kg": -0.12,
  "safe_progression_bounds": {
    "weekly_change_kg_min": -0.33,
    "weekly_change_kg_max": 0.08,
    "total_change_kg_min": -3.94,
    "total_change_kg_max": 0.98
  },
  "weekly_targets": [
    {"week": 1, "target_weight_kg": 81.88, "change_from_start_kg": -0.12},
    {"week": 2, "target_weight_kg": 81.75, "change_from_start_kg": -0.25}
  ],
  "weekly_execution_targets": ["Hold protein and progressive training consistency"],
  "course_correction_triggers": ["Adjust intake if trend diverges for 2 consecutive weeks"],
  "compliance_scorecard": ["Track adherence to training, sleep, and nutrition"],
  "review_schedule": {"weekly": "trend review", "monthly": "strategy adjustment"},
  "summary": "Gradual progression target supports sustainable recomposition.",
  "adjustment_logic": "Use small weekly adjustments while preserving performance.",
  "safety_note": "Avoid aggressive shifts outside safe progression bounds.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "5df3ca7f3f4bad5e", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_progression_targets", "response_language": "en"}
}

Product Positioning

Designed for coaching suites, body transformation apps, and progress analytics dashboards.

Note

time_horizon_weeks must be between 2 and 52.