Energy & macros

Daily protein target

Daily protein target from body weight and activity: the IOM RDA for the life stage (0.8 g/kg for adults; 0.85 at 14 to 18, 1.1 in the second half of pregnancy, 1.3 while breastfeeding) and a g/kg range scaled to activity level (up to the 1.2 to 2.0 g/kg athlete range, and never under the RDA), in grams per day. Under 18 the answer is the RDA alone: range is null, byActivity is empty and activity_range_withheld is "under_18", because the activity ranges are adult sports-nutrition guidance.

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

get/calculate/protein

Request

  • Base URL: https://myplate.food/api/v1
  • URL: https://myplate.food/api/v1/calculate/protein
  • Auth: none declared

Query parameters

ageinteger required

Age in years.

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. The protein RDA follows it.

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

Breastfeeding status. 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.