Skip to content

Body Recomposition Forecast API

Estimate expected fat-loss vs muscle-gain trajectory and probability of successful recomp, including 4/8/12-week projection blocks.

Endpoint

  • GET /api/v1/fitness/body-recomp-forecast
  • POST /api/v1/fitness/body-recomp-forecast/post

Parameters

Name Type Required In Description
current_weight number (35-300) Yes Query/Body Current body weight in kg.
body_fat_percentage number (5-60) Yes Query/Body Current body fat percent.
calorie_intake number (800-6000) Yes Query/Body Average daily intake.
protein_intake number (40-450) Yes Query/Body Daily protein in grams.
training_days integer (0-7) Yes Query/Body Resistance training days per week.
experience_level string Yes Query/Body beginner,intermediate,advanced,elite.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Turn static intake/training data into projected recomposition outcomes.
  • Prioritize users by recomp probability for coaching interventions.
  • Offer timeline visibility to improve adherence and retention.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "current_weight": 84,
    "body_fat_percentage": 24,
    "calorie_intake": 2350,
    "protein_intake": 165,
    "training_days": 4,
    "experience_level": "intermediate"
  }'

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.

{
  "current_weight_kg": 84.0,
  "body_fat_percentage": 24.0,
  "calorie_intake": 2350,
  "protein_intake_g": 165.0,
  "training_days": 4,
  "experience_level": "intermediate",
  "experience_level_label": "Intermediate",
  "estimated_fat_loss_vs_muscle_gain_ratio": {
    "fat_loss_kg_per_week": 0.23,
    "muscle_gain_kg_per_week": 0.13,
    "fat_to_muscle_ratio": 1.77,
    "ratio_label": "balanced_recomp",
    "ratio_label_text": "Balanced recomp"
  },
  "recomp_probability_score": {
    "score": 73,
    "band": "moderate",
    "band_label": "Moderate",
    "insight": "Good potential with consistency."
  },
  "timeline_projection": [
    {
      "week": 4,
      "projected_weight_kg": 83.6,
      "projected_body_fat_percent": 23.2,
      "estimated_fat_mass_change_kg": -0.92,
      "estimated_lean_mass_change_kg": 0.52
    }
  ],
  "strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
  "metabolic_context": {
    "estimated_maintenance_calories": 2720,
    "daily_energy_gap": -370,
    "protein_g_per_kg": 1.96
  },
  "confidence_score": 84,
  "summary": "Consistent execution can deliver measurable recomposition.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "4b2ad1f68d3dc50a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_body_recomp_forecast",
    "response_language": "en"
  }
}

Market Positioning

Excellent for high-engagement coaching platforms and premium fitness products where users need visible, probability-based progress forecasting.

Note

Validation is strict on all range-bound inputs (weight, body fat, calories, protein, and training days).