Skip to content

Adaptive Training Load API

Return a readiness-aware training decision (push, maintain, pull_back) with intensity delta, volume adjustment, injury shift, and confidence score.

Endpoint

  • GET /api/v1/fitness/adaptive-training-load
  • POST /api/v1/fitness/adaptive-training-load/post

Parameters

Name Type Required In Description
planned_intensity number (1-10) Yes Query/Body Planned session intensity.
recovery_score number (0-100) Yes Query/Body Aggregate recovery score.
sleep_hours number (0-16) Yes Query/Body Last-night sleep duration.
hrv number (10-200) Yes Query/Body HRV input used for readiness scoring.
muscle_soreness number (0-10) Yes Query/Body Subjective soreness rating.
goal string Yes Query/Body fat_loss, muscle_gain, performance, maintenance, recomposition.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Deliver auto-regulation as a service for training apps.
  • Reduce overtraining risk using objective + subjective readiness inputs.
  • Provide explainable session adjustments for athletes and coaches.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load?planned_intensity=7&recovery_score=74&sleep_hours=7.2&hrv=58&muscle_soreness=4&goal=performance&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "planned_intensity": 7,
    "recovery_score": 74,
    "sleep_hours": 7.2,
    "hrv": 58,
    "muscle_soreness": 4,
    "goal": "performance"
  }'

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.

{
  "planned_intensity": 7.0,
  "adjusted_training_intensity_recommendation": 7.9,
  "adjusted_training_intensity_delta": 0.9,
  "volume_adjustment_percent": 8,
  "decision": "push",
  "decision_label": "Push",
  "injury_probability_shift_percent_points": -1.8,
  "performance_optimization_note": "Readiness supports a progressive session.",
  "confidence_score": 87,
  "confidence_label": "High",
  "goal": "performance",
  "goal_label": "Performance",
  "readiness_signals": {
    "recovery_score": 74.0,
    "sleep_hours": 7.2,
    "hrv": 58.0,
    "muscle_soreness": 4.0,
    "composite_readiness_score": 75.8
  },
  "recommended_action_blocks": [
    "Increase load slightly on primary lift.",
    "Keep movement quality high across sets."
  ],
  "summary": "Train hard with quality control.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "35ce4816f312aa0b",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_adaptive_training_load",
    "response_language": "en"
  }
}

Market Fit

Best for premium coaching, athlete monitoring, and adaptive programming products where daily training decisions drive retention and outcomes.

Note

Validation enforces strict ranges for intensity, recovery score, HRV, sleep, and soreness.