Skip to content

Running Economy API

Quantify running efficiency and return training levers that improve speed-per-effort outcomes.

Endpoint

  • GET /api/v1/fitness/running-economy
  • POST /api/v1/fitness/running-economy/post

Parameters

Name Type Required In Description
pace_per_km number (2.0-15.0) Yes Query/Body Average pace per kilometer (minutes).
heart_rate_avg number (80-210) Yes Query/Body Average heart rate in bpm.
vo2max number (15-90) Yes Query/Body VO2 max estimate/value.
body_weight number (35-250) Yes Query/Body Body weight in kg.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Transform run data into one clear efficiency signal.
  • Benchmark performance via percentile and banding.
  • Return practical lever suggestions for improvement.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/running-economy?pace_per_km=4.9&heart_rate_avg=162&vo2max=51&body_weight=73&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/running-economy/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"pace_per_km":5.6,"heart_rate_avg":171,"vo2max":45,"body_weight":80}'

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.

{
  "pace_per_km": 4.9,
  "heart_rate_avg_bpm": 162.0,
  "vo2max_ml_kg_min": 51.0,
  "body_weight_kg": 73.0,
  "running_efficiency_score": 79,
  "efficiency_band": {"band": "strong", "band_label": "Strong", "insight": "Strong economy profile with room for refinement."},
  "economy_percentile": 79,
  "economy_index": 33.2,
  "efficiency_components": {"pace_component": 41.4, "heart_rate_component": 15.4, "aerobic_component": 39.0, "mass_penalty": 2.9},
  "improvement_lever_suggestions": ["Use threshold intervals and aerobic volume consistency"],
  "stimulus_focus": "Threshold + aerobic durability",
  "confidence_score": 87,
  "summary": "Running economy is strong with targeted gains available.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "93027cd0f866757d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_running_economy", "response_language": "en"}
}

Product Positioning

A differentiated feature for endurance analytics, training apps, and race-performance products.

Note

pace_per_km expects minutes-per-km format, not speed in km/h.