Skip to content

VO2max Estimate API

Build cardiorespiratory fitness profiles from field-test performance and resting physiology.

Endpoint

  • GET /api/v1/fitness/vo2max-estimate
  • POST /api/v1/fitness/vo2max-estimate/post

Parameters

Name Type Required In Description
age integer (13-85) Yes Query/Body Age in years.
gender string Yes Query/Body male or female.
resting_hr number (30-130) Yes Query/Body Resting HR in bpm.
cooper_test_distance number (800-5000) Conditionally Query/Body 12-min Cooper distance in meters.
1_5_mile_time number (6-30) Conditionally Query/Body 1.5-mile run time in minutes.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Blend multiple VO2 estimate methods in one response.
  • Add classification, percentile, and training focus guidance.
  • Support fitness-age and risk insight features.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate?age=33&gender=male&resting_hr=56&cooper_test_distance=2800&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":29,"gender":"female","resting_hr":60,"1_5_mile_time":11.8}'

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.

{
  "age": 33,
  "gender": "male",
  "resting_hr_bpm": 56.0,
  "test_inputs": {"cooper_test_distance_m": 2800.0, "run_1_5_mile_time_min": null},
  "estimate_method": "cooper_blend",
  "estimate_method_label": "Cooper Blend",
  "vo2max_estimate_ml_kg_min": 51.2,
  "vo2max_range_ml_kg_min": {"lower": 45.1, "upper": 57.3},
  "fitness_classification": "excellent",
  "fitness_classification_label": "Excellent",
  "percentile_estimate": 87,
  "confidence": {"score": 84, "level": "medium", "level_label": "Medium", "notes": "Single-test blend provides solid directional estimate."},
  "cardiorespiratory_risk_insight": "Favorable cardiorespiratory profile.",
  "training_focus_recommendations": ["Maintain aerobic base and threshold progressions"],
  "derived_metrics": {"estimated_hr_max_bpm": 185, "hr_reserve_bpm": 129, "fitness_age_estimate_years": 28},
  "summary": "Excellent aerobic profile with strong performance potential.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "31a83dfecbe5a34b", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_vo2max_estimate", "response_language": "en"}
}

Product Positioning

A high-value endpoint for endurance apps, wellness scoring, and training diagnostics platforms.

Note

Provide at least one field test input: cooper_test_distance or 1_5_mile_time.