Skip to content

Training Archetype API

Map user behavior and motivation into a practical archetype and program strategy recommendation.

Endpoint

  • GET /api/v1/fitness/training-archetype
  • POST /api/v1/fitness/training-archetype/post

Parameters

Name Type Required In Description
preferred_training_style string Yes Query/Body strength,endurance,hybrid,functional,mind_body.
recovery_rate number (1-10) Yes Query/Body Self-rated recovery score.
motivation_type string Yes Query/Body intrinsic,competitive,social,data_driven,habit_based.
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

  • Personalize training UX beyond generic goal templates.
  • Add burnout-risk intelligence to programming decisions.
  • Increase adherence via archetype-aligned plan styles.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/training-archetype?preferred_training_style=hybrid&recovery_rate=6.8&motivation_type=data_driven&goal=recomposition&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/training-archetype/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"preferred_training_style":"strength","recovery_rate":5.4,"motivation_type":"competitive","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.

{
  "preferred_training_style": "hybrid",
  "preferred_training_style_label": "Hybrid",
  "recovery_rate": 6.8,
  "motivation_type": "data_driven",
  "motivation_type_label": "Data Driven",
  "goal": "recomposition",
  "goal_label": "Recomposition",
  "athlete_archetype": {"type": "adaptive_hybrid", "type_label": "Adaptive Hybrid", "insight": "You respond well to varied stimulus with structure."},
  "ideal_program_style": {"type": "dual_focus_rotation", "type_label": "Dual Focus Rotation", "insight": "Alternate emphasis while maintaining total consistency."},
  "burnout_risk_pattern": {"score": 55, "level": "moderate", "level_label": "Moderate", "insight": "Manage intensity clustering to avoid cumulative fatigue."},
  "strategic_recommendation": ["Use planned intensity waves and recovery anchors"],
  "next_review_window_days": 21,
  "summary": "Hybrid profile with moderate burnout risk and strong adaptability.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "1582fd58511dbe57", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_training_archetype", "response_language": "en"}
}

Product Positioning

High-impact personalization endpoint for enterprise coaching and premium training products.

Note

recovery_rate must be between 1 and 10.