Skip to content

THR API

Generate practical target heart-rate range for cardio programming based on fitness profile.

Endpoint

  • GET /api/v1/thr
  • POST /api/v1/thr/post

Parameters

Name Type Required In Description
age integer (>0) Yes Query/Body Age in years.
fitness_level string Yes Query/Body beginner,intermediate,advanced.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Quick target zone generation for cardio sessions.
  • Simple progression from beginner to advanced intensity zones.
  • Useful for onboarding and program templates.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/thr?age=35&fitness_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/thr/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":42,"fitness_level":"advanced"}'

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.

{
  "thr_min": "111.0 bpm",
  "thr_max": "157.25 bpm",
  "age": 35,
  "fitness_level": "intermediate",
  "max_heart_rate": 185,
  "target_zone_bpm": {"min": 111.0, "max": 157.25},
  "intensity_band": "build",
  "intensity_label": "Build",
  "risk_signal": "Progressive zone; monitor exertion quality.",
  "action_plan": ["Use progressive interval blocks"],
  "monitoring_plan": "Track session RPE and HR drift.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "7e2a8b7b8bf3fc2e", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "thr", "response_language": "en"}
}

Product Positioning

A lightweight core endpoint for cardio planning apps and beginner-friendly coaching stacks.

Note

fitness_level must be one of beginner, intermediate, advanced.