Skip to content

Maintenance Calorie API

Compute BMR and maintenance calories with practical fat-loss and muscle-gain target ranges.

Endpoint

  • GET /api/v1/maintenance-calorie
  • POST /api/v1/maintenance-calorie/post

Parameters

Name Type Required In Description
sex string Yes Query/Body male or female.
age number (>0) Yes Query/Body Age in years.
height number (>0) Yes Query/Body Height in cm (metric) or inches (imperial).
weight number (>0) Yes Query/Body Weight in kg (metric) or lb (imperial).
unit string Yes Query/Body metric or imperial.
activity_level string Yes Query/Body little/no exercise,1-2 times/week,2-3 times/week,3-5 times/week,6-7 times/week,pro athlete.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Provide a stable calorie baseline before macro planning.
  • Return target ranges for fat loss, maintenance, and gain.
  • Improve adherence with guidance and monitoring fields.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/maintenance-calorie?sex=female&age=31&height=167&weight=68&unit=metric&activity_level=3-5%20times/week&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/maintenance-calorie/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","age":36,"height":71,"weight":186,"unit":"imperial","activity_level":"2-3 times/week"}'

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.

{
  "sex": "female",
  "age": 31.0,
  "height_cm": 167.0,
  "weight_kg": 68.0,
  "unit": "metric",
  "activity_level": "3-5 times/week",
  "bmr_kcal_per_day": 1417.75,
  "activity_multiplier": 1.75,
  "m_calorie_kcal_per_day": 2481.06,
  "calorie_band": "moderate",
  "calorie_band_label": "Moderate",
  "goal_targets_kcal": {
    "fat_loss": 2109,
    "maintenance": 2481,
    "muscle_gain": 2729
  },
  "priority_focus": ["Track adherence before major changes"],
  "activity_guidance": ["Sustain weekly movement consistency"],
  "adjustment_rules": ["Adjust by 100-150 kcal based on trend"],
  "monitoring_plan": "Review bodyweight and energy levels weekly.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "d21562072ea3f83f",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "maintenance_calorie",
    "response_language": "en"
  }
}

Product Positioning

A foundational endpoint for nutrition suites, coaching CRMs, and digital health programs.

Note

activity_level must match one of the exact supported strings.