Skip to content

EER API

Compute EER and return practical calorie targets for fat loss, maintenance, and muscle gain.

Endpoint

  • GET /api/v1/eer
  • POST /api/v1/eer/post

Parameters

Name Type Required In Description
gender string (male,female) Yes Query/Body Biological sex.
age integer Yes Query/Body Age in years.
weight number Yes Query/Body Weight in kilograms.
height number Yes Query/Body Height in centimeters.
activity_level string Yes Query/Body sedentary,low active,active,very active.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Build evidence-based calorie budgets from standardized formulas.
  • Add activity-factor visibility for user education.
  • Support personalized nutrition planning at scale.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/eer?gender=female&age=34&weight=66&height=168&activity_level=active&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/eer/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"female","age":34,"weight":66,"height":168,"activity_level":"active"}'

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.

{
  "EER": "2351.36 kcal/day",
  "Gender": "female",
  "Age": "34 yr",
  "Weight": "66.0 kg",
  "Height": "168.0 cm",
  "Activity Level": "active",
  "eer_kcal_per_day": 2351.36,
  "activity_factor": 1.27,
  "energy_band": "moderate",
  "energy_band_label": "Moderate",
  "goal_targets_kcal_per_day": {
    "fat_loss": 1999,
    "maintenance": 2351,
    "muscle_gain": 2587
  },
  "risk_signal": "Energy requirement is moderate.",
  "action_plan": ["Match intake to goal phase"],
  "monitoring_plan": "Recompute on profile changes.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "54d8b43189e1ec8c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "eer",
    "response_language": "en"
  }
}

Commercial Use

Well-suited for nutrition engines, coaching SaaS, and enterprise wellness platforms.

Note

activity_level must match the endpoint enum values exactly.