Body metrics

Body-fat % (U.S. Navy circumference method)

Estimate body-fat % using the U.S. Navy circumference method, with a Deurenberg BMI-based cross-check and ACE category. Needs neck and waist measurements (plus hip for women).

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

get/calculate/body-fat

Request

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

Query parameters

sex'male' | 'female' required

Biological sex — drives the equation.

ageinteger required

Age in years (18–80). The Deurenberg cross-check and the ACE category bands are adult references; the Navy equation itself does not use age.

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).

neck_cmnumber

Neck circumference in cm (or neck_in).

neck_innumber

Neck circumference in inches.

waist_cmnumber

Waist circumference in cm (or waist_in).

waist_innumber

Waist circumference in inches.

hip_cmnumber

Hip circumference in cm — required for women (or hip_in).

hip_innumber

Hip circumference in inches (women).

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.