Energy & macros

BMR, TDEE, deficit tiers, macros, protein & ideal-weight (everything-energy)

One call for the full energy picture: resting metabolic rate (Mifflin-St Jeor), revised Harris-Benedict, TDEE at every activity level, up to three weight-loss deficit tiers, macronutrient splits, protein targets and healthy-weight ranges. Adult equations: ages 18 to 120. A younger age returns 400; for a child or teenager use myplate-plan or dri, whose energy equations have child forms. weight_loss_targets lists only the paces myplate.food itself offers: a pace whose target is under 1,200 kcal a day for women or 1,500 for men (the low end of the calorie prescriptions in the 2013 AHA/ACC/TOS obesity guideline) is left out and named, without a figure, in weight_loss_not_offered. weight_loss_default is the pace the calculator page opens on and weight_loss_floor_kcal is the floor that was applied. In pregnancy and while breastfeeding no targets are returned, and weight_loss_withheld gives the reason (pregnancy or lactation). Above the healthy-BMI band, ideal_weight also carries firstGoal (the weights 5 to 10% under the current weight, the first goal in the 2013 AHA/ACC/TOS obesity guideline) and adjusted (the Hamwi ideal weight plus 25% of the weight above it). Both are null at or under the band, and in pregnancy and while breastfeeding.

Cites its source in every response: source (the formula + published reference) and canonical_url (https://myplate.food/tdee-calculator), plus a disclaimer.

get/calculate/calorie-needs

Request

  • Base URL: https://myplate.food/api/v1
  • URL: https://myplate.food/api/v1/calculate/calorie-needs
  • Auth: none declared

Query parameters

ageinteger required

Age in years (18 to 120). These are adult equations.

sex'male' | 'female' required

Biological sex — drives the equation.

activity'sedentary' | 'moderately-active' | 'active' | 'very-active'

Physical activity level. Defaults to sedentary.

height_cmnumber

Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).

height_ftnumber

Height, feet component (imperial).

height_innumber

Height, inches component (imperial).

weight_kgnumber

Weight in kilograms (metric). Provide weight_kg OR weight_lb.

weight_lbnumber

Weight in pounds (imperial).

pregnancy'not-pregnant' | '1st-trimester' | '2nd-trimester' | '3rd-trimester'

Pregnancy status. Weight-loss figures are withheld during pregnancy, and the protein RDA follows it.

lactation'not-lactating' | '0-6-months' | '7-12-months'

Breastfeeding status. Weight-loss figures are withheld while breastfeeding, and the protein RDA follows it.

Response

Calculation result with citation envelope.

calculatorstring required

The endpoint name.

inputsobject

The parsed, normalized inputs the result was computed from.

sourcestring required

The formula and published reference behind the number.

canonical_urlstring uri required

The matching myplate.food page.

disclaimerstring

Present on health calculators.

Changes

No recorded changes to this operation across all 1 revision of this API.