Skip to content

TDEE API

Estimate total daily energy expenditure with Mifflin or Harris equation paths.

Endpoint

  • GET /api/v1/tdee
  • POST /api/v1/tdee/post

Parameters

Name Type Required In Description
gender string Yes Query/Body male or female.
age integer Yes Query/Body Age in years.
weight number Yes Query/Body Weight in kg.
height number Yes Query/Body Height in cm.
activity_level string Yes Query/Body Supported activity key from endpoint set.
equation string No Query/Body mifflin (default) or harris.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Build calorie systems on a reliable daily expenditure baseline.
  • Compare equation paths while keeping unified response schema.
  • Drive fat-loss/gain target automation from one call.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/tdee?gender=male&age=34&weight=82&height=178&activity_level=moderately_active&equation=mifflin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/tdee/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"female","age":30,"weight":68,"height":167,"activity_level":"lightly_active","equation":"harris"}'

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.

{
  "TDEE": "2758.13 kcal/day",
  "Gender": "Male",
  "Age": "34 yr",
  "Weight": "82.0 kg",
  "Height": "178.0 cm",
  "Activity Level": "Moderately Active",
  "BMR": "1779.44 kcal/day",
  "tdee_kcal_per_day": 2758.13,
  "bmr_kcal_per_day": 1779.44,
  "activity_multiplier": 1.55,
  "equation_used": "mifflin",
  "energy_band": "high",
  "energy_band_label": "High",
  "goal_targets_kcal_per_day": {"fat_loss": 2344, "maintenance": 2758, "muscle_gain": 3034},
  "risk_signal": "Higher intake profile requires precision for composition goals.",
  "action_plan": ["Track weekly trend and adjust in small steps"],
  "monitoring_plan": "Review trend and intake adherence weekly.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f57b7f25a5607f29", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "tdee", "response_language": "en"}
}

Product Positioning

Foundational API for nutrition engines, metabolic calculators, and coaching platforms.

Note

equation supports only mifflin or harris.