Fitness API Reference

Technical specifications for the HealthIQ RapidAPI Fitness operations.

Basic Tier

Calories Burned

Calculates total energy expenditure roughly based on Metabolic Equivalent (MET) task values.
POST /v1/fitness/calories-burned
Request Parameters
ParameterTypeRange / OptionsDescription
WeightNumber> 0 (kg)Body weight of the user in kilograms.
ActivityTypeString walking_2mph, walking_3mph, walking_4mph, walking_uphill,
running_5mph, running_6mph, running_7mph, running_8mph, running_trail,
cycling_leisure, cycling_10mph, cycling_12mph, cycling_14mph, cycling_mountain,
swimming_light, swimming_moderate, swimming_vigorous,
strength_training_light, strength_training_moderate, strength_training_vigorous, bodyweight_training,
hiit, aerobics, dance, boxing, yoga, stretching,
house_cleaning, gardening, jump_rope, stairs 		The physical activity performed.
DurationMinutesNumber> 0 (mins)Time spent exercising in minutes.
Example JSON Request
{
  "weight": 75.0,
  "activityType": "running_6mph",
  "durationMinutes": 30.0
}
Response Parameters
ParameterTypeRange / OptionsDescription
caloriesBurnedNumberkcalCalculated calories burned.
metNumberscoreMetabolic Equivalent score tied to the activity.
activityTypeStringechoReturns the activity type submitted.
durationMinutesNumberminsReturns the duration submitted.
intensityProfileStringlight activity, moderate activity, intense activityCategorical summary of session intensity.
summaryStringtextHuman readable wrap-up of the results.
Example JSON Response
{
  "caloriesBurned": 340.5,
  "met": 9.8,
  "activityType": "running_6mph",
  "durationMinutes": 30.0,
  "intensityProfile": "moderate activity",
  "summary": "You burned 340 kcal during a moderate activity session of running lasting 30 minutes."
}
Pro Tier

Heart Rate Zones

Calculates personalized aerobic fitness thresholds mapped to advanced cardiovascular models (Karvonen, Tanaka, LTHR, Fox, Zoladz).
POST /v1/fitness/heart-rate-zones
Request Parameters
ParameterTypeRange / OptionsDescription
AgeNumber1-120Chronological age of the user.
RestingHeartRateNumber40-120 (bpm)Measured resting heart rate in beats per minute.
FormulaStringKarvonen, Tanaka, Zoladz, LTHR, FoxEquation paradigm. (Optional: default Karvonen)
LactateThresholdNumber> 0 (bpm)Explicit LTHR target marker (Required if using LTHR formula).
Example JSON Request
{
  "age": 30,
  "restingHeartRate": 65,
  "formula": "Karvonen",
  "lactateThreshold": null
}
Response Parameters
ParameterTypeRange / OptionsDescription
maxHeartRateNumberbpmCalculated maximum heart rate.
zonesObjectDictionaryA key-value dictionary mapping 5 target zones.
summaryStringtextHuman readable wrap-up of the results.
Example JSON Response
{
  "maxHeartRate": 190,
  "zones": {
    "Zone 1 (Recovery)": "95 - 114 bpm",
    "Zone 2 (Aerobic)": "114 - 133 bpm",
    "Zone 3 (Tempo)": "133 - 152 bpm",
    "Zone 4 (Lactate)": "152 - 171 bpm",
    "Zone 5 (Anaerobic)": "171 - 190 bpm"
  },
  "summary": "Calculated 5 target heart rate zones based on the Karvonen formula."
}
Ultra Tier

One Rep Max

Predicts absolute maximum lifting capacity using standardized mathematical physiological formulas.
POST /v1/fitness/one-rep-max
Request Parameters
ParameterTypeRange / OptionsDescription
WeightLiftedNumber> 0 (kg/lbs)Amount of weight successfully lifted.
RepsNumber1-20Number of repetitions completed (for best accuracy keep under 10).
FormulaStringepley, brzycki, lander, oconner, mayhew, wathan, lombardi, schwartzEquation paradigm. (Optional: default epley)
ProfileStringstrength, hypertrophy, warmupDetermines resulting percentage chart outputs.
Example JSON Request
{
  "weightLifted": 135.0,
  "reps": 10,
  "formula": "epley",
  "profile": "strength"
}
Response Parameters
ParameterTypeRange / OptionsDescription
estimatedOneRepMaxNumberunits matchedEstimated theoretical raw 1 Rep Max limit.
percentagesObjectDictionaryA key-value dictionary mapping weight thresholds and recommended reps.
summaryStringtextSummary indicating formula mapped.
Example JSON Response
{
  "estimatedOneRepMax": 180.0,
  "percentages": {
    "90%": { "weight": 162.0, "reps": 3 },
    "80%": { "weight": 144.0, "reps": 8 },
    "70%": { "weight": 126.0, "reps": 12 }
  },
  "summary": "1RM estimated using the Epley formula with Strength profile."
}
Mega Tier

Generate Workout

AI-driven routine synthesizer generating weekly schedules mapped to specific recovery windows.
POST /v1/fitness/generate-workout
Request Parameters
ParameterTypeRange / OptionsDescription
GoalStringhypertrophy, strength, endurance, weight_loss, general_fitnessPrimary adaptation goal of the athlete.
DaysPerWeekNumber1-7Frequency of available training days.
Example JSON Request
{
  "goal": "hypertrophy",
  "daysPerWeek": 4
}
Response Parameters
ParameterTypeRange / OptionsDescription
weeklyScheduleArray[String]Schedule linesArray containing generated workout texts per day.
routineTypeStringFull Body Split, Upper / Lower Split, Push / Pull / Legs SplitThe macro split archetype used (e.g., Upper/Lower).
daysPerWeekNumberechoThe length span submitted.
goalStringechoThe target goal submitted.
summaryStringtextHuman readable wrap-up of the generated split.
Example JSON Response
{
  "weeklySchedule": [
     "Day 1: Upper Primary - Barbell Bench Press, Incline Dumbbell Press, Pull Up, Dumbbell Curl, Tricep Pushdown (Volume: 3-4 sets x 8-12 reps)",
     "Day 2: Lower Primary - Barbell Squat, Leg Press, Romanian Deadlift, Calf Raise, Plank (Volume: 3-4 sets x 8-12 reps)",
     "Day 3: Upper Secondary - Overhead Press, T-Bar Row, Chest Dip, Preacher Curl, Skullcrusher (Volume: 3-4 sets x 8-12 reps)",
     "Day 4: Lower Secondary - Front Squat, Lying Leg Curl, Bulgarian Split Squat, Seated Calf Raise, Cable Crunch (Volume: 3-4 sets x 8-12 reps)"
  ],
  "routineType": "Upper / Lower Split",
  "daysPerWeek": 4,
  "goal": "hypertrophy",
  "summary": "Generated a 4-day Upper / Lower Split program focused on hypertrophy."
}