Skip to content

Volume Load Analysis API

Convert training volume metrics into hypertrophy classification and risk-aware programming guidance.

Endpoint

  • GET /api/v1/fitness/volume-load-analysis
  • POST /api/v1/fitness/volume-load-analysis/post

Parameters

Name Type Required In Description
total_sets integer (1-60) Yes Query/Body Weekly set count.
avg_reps number (1-40) Yes Query/Body Average reps per set.
avg_load number (1-500) Yes Query/Body Average load per rep (kg-equivalent context).
muscle_group string Yes Query/Body chest,back,legs,shoulders,arms,glutes,core,full_body.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Classify training dose against hypertrophy zones.
  • Detect overload patterns before recovery failure.
  • Feed coach dashboards with interpretable volume signals.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis?total_sets=18&avg_reps=10&avg_load=75&muscle_group=legs&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"total_sets":26,"avg_reps":12,"avg_load":68,"muscle_group":"back"}'

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.

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "total_sets": 18,
  "avg_reps": 10.0,
  "avg_load": 75.0,
  "weekly_volume_load": {"tonnage": 13500, "per_set_density": 750.0},
  "hypertrophy_zone_classification": {"zone": "hypertrophy_optimal", "zone_label": "Hypertrophy Optimal", "insight": "Current load is well-positioned for growth adaptation."},
  "overuse_warning": {"level": "low", "level_label": "Low"},
  "hypertrophy_efficiency_score": 100,
  "load_distribution_note": "Balanced volume and intensity profile.",
  "recommendations": ["Maintain progression while protecting recovery"],
  "next_review_window_days": 21,
  "confidence_score": 80,
  "summary": "Optimal hypertrophy dose with manageable fatigue profile.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "ef35d53f9622ec8a", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_volume_load_analysis", "response_language": "en"}
}

Product Positioning

Designed for strength analytics products, coach tools, and performance dashboards.

Note

muscle_group must match the supported enum set.