Skip to content

Weekly Check-In Analysis API

Turn weekly weight, strength, recovery, and adherence signals into an actionable progress decision.

Endpoint

  • GET /api/v1/fitness/weekly-checkin-analysis
  • POST /api/v1/fitness/weekly-checkin-analysis/post

Parameters

Name Type Required In Description
weight_change number (-10 to 10) Yes Query/Body Weekly bodyweight change in kg.
strength_change number (-30 to 30) Yes Query/Body Weekly strength change percentage.
recovery_score_avg number (0-100) Yes Query/Body Average recovery score.
calorie_adherence_percent number (0-150) Yes Query/Body Nutrition adherence percent.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Standardize weekly check-in decisions at scale.
  • Surface intervention flags automatically.
  • Improve coaching consistency with momentum scoring.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis?weight_change=-0.6&strength_change=1.8&recovery_score_avg=71&calorie_adherence_percent=88&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weight_change":-1.3,"strength_change":-2.4,"recovery_score_avg":54,"calorie_adherence_percent":72}'

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.

{
  "weight_change_kg": -0.6,
  "strength_change_percent": 1.8,
  "recovery_score_avg": 71.0,
  "calorie_adherence_percent": 88.0,
  "progress_interpretation": {"status": "on_track", "status_label": "On Track", "insight": "Current trend supports target progress."},
  "adjustment_recommendations": ["Maintain current structure and monitor consistency"],
  "weekly_priority_protocol": {"focus": "execution consistency"},
  "next_week_focus": ["Preserve recovery and progressive overload"],
  "intervention_matrix_flags": [],
  "review_schedule": {"next_checkin_days": 7},
  "momentum_rating": {"score": 83, "rating": "high", "rating_label": "High", "summary": "Momentum is strong and stable."},
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f359506a436d1e2d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_weekly_checkin_analysis", "response_language": "en"}
}

Product Positioning

Great for coaching check-ins, habit tracking, and enterprise performance monitoring.

Note

calorie_adherence_percent allows values above 100 to represent over-adherence/over-compliance.