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.
Request
- Base URL: https://myplate.food/api/v1
- URL: https://myplate.food/api/v1/calculate/calorie-needs
- Auth: none declared
Query parameters
Age in years (18 to 120). These are adult equations.
Biological sex — drives the equation.
Physical activity level. Defaults to sedentary.
Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).
Height, feet component (imperial).
Height, inches component (imperial).
Weight in kilograms (metric). Provide weight_kg OR weight_lb.
Weight in pounds (imperial).
Pregnancy status. Weight-loss figures are withheld during pregnancy, and the protein RDA follows it.
Breastfeeding status. Weight-loss figures are withheld while breastfeeding, and the protein RDA follows it.
Response
Calculation result with citation envelope.
Changes
No recorded changes to this operation across all 1 revision of this API.