Skip to content

BMR API

Calculate BMR and produce useful planning outputs for fat loss, maintenance proxy, and muscle gain ranges.

Endpoint

  • GET /api/v1/bmr
  • POST /api/v1/bmr/post

Parameters

Name Type Required In Description
age integer Yes Query/Body Age in years.
weight number Yes Query/Body Weight in kilograms.
height number Yes Query/Body Height in centimeters.
gender string (male,female) Yes Query/Body Biological sex.
equation string (mifflin,harris) No Query Formula selector (defaults to mifflin).
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Support calorie planning in onboarding and coaching flows.
  • Compare equation behavior with explicit formula control.
  • Add interpretable metabolic bands for personalization engines.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/bmr?age=34&weight=78&height=175&gender=male&equation=mifflin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/bmr/post?equation=mifflin&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age": 34, "weight": 78, "height": 175, "gender": "male"}'

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.

{
  "bmr": "1708.75 kcal/day",
  "bmr_kcal_per_day": 1708.75,
  "profile": {
    "age": 34,
    "weight_kg": 78.0,
    "height_cm": 175.0,
    "gender": "male",
    "equation": "mifflin"
  },
  "metabolic_band": "moderate",
  "metabolic_band_label": "Moderate",
  "target_calorie_ranges": {
    "fat_loss": 1743,
    "maintenance_proxy": 2221,
    "muscle_gain": 2392
  },
  "risk_signal": "Energy needs are moderate and manageable.",
  "action_plan": ["Align intake with goal phase", "Track weekly response"],
  "monitoring_plan": "Recalculate when weight changes materially.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "b76dbf5f8f5729c1",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "bmr",
    "response_language": "en"
  }
}

Product Positioning

A core endpoint for nutrition SaaS, coaching apps, and enterprise health intelligence systems that need baseline energy modeling.

Note

equation is passed as query parameter on both GET and POST endpoint variants.