curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

BMI API

Body mass index for adults from weight and height in metric or imperial units, with the WHO/CDC weight category and the healthy weight range for that height.

POST https://api.curatedapi.com/v1/calc/health/bmi

Computes BMI = weight (kg) ÷ height (m)² from exact unit definitions, so imperial inputs need no 703 approximation. The category is decided on the exact BMI, so a BMI of 24.96 is 'Healthy weight' even though it displays as 25.0; the response warns when rounding crosses a band boundary like that.

Formula

BMI = kg / m²; 1 lb = 0.45359237 kg, 1 in = 0.0254 m exactly
  • For adults (age 20 and over) only. Children and teens need age- and sex-specific BMI percentiles instead.
  • BMI is a screening measure, not a diagnosis. It does not tell muscle from fat, so it can overstate body fat for athletes and understate it for older adults.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
weight required decimal (string) Body weight in weight_unit. Allowed: > 0 and <= 2000.
weight_unit kg | lb | st
default kg
Unit of weight. Options: kg: kilograms; lb: pounds (0.45359237 kg); st: stone (14 lb)
height required decimal (string) Height in height_unit. Allowed: > 0 and <= 300.
height_unit cm | m | in | ft
default cm
Unit of height. Options: cm: centimetres; m: metres; in: inches (2.54 cm); ft: feet (12 in); add the rest with height_inches
height_inches decimal (string) Extra inches when height_unit is ft (5 ft 10 in is height 5, height_inches 10). Allowed: >= 0 and < 12.
options.rounding half_even | half_up | half_down | up | down | ceiling | floor Rounding mode applied once to each result. Default half_even.
options.decimals integer Round results to this many digits after the decimal point.
options.significant_digits integer Round results to this many significant digits.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
bmidecimal (string)Body mass index in kg/m². Unit: kg/m².
categorystringWeight category code: underweight, healthy_weight, overweight, obesity_class_1, obesity_class_2 or obesity_class_3.
category_labelstringWeight category in words.
healthy_weight_mindecimal (string)Lowest weight in the healthy band (BMI 18.5) for this height, in weight_unit.
healthy_weight_maxdecimal (string)Weight at BMI 25 for this height, in weight_unit (the healthy band ends just below it).
weight_kgstringWeight in kilograms, exact (not rounded).
height_mstringHeight in metres, exact (not rounded).

Examples

Metric

Requestcurl
curl https://api.curatedapi.com/v1/calc/health/bmi \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "weight": "70",
    "height": "175"
  }'
200 OKResponse
{
  "calculator": "health/bmi@1",
  "result": {
    "bmi": "22.9",
    "category": "healthy_weight",
    "category_label": "Healthy weight",
    "healthy_weight_min": "56.7",
    "healthy_weight_max": "76.6",
    "weight_kg": "70",
    "height_m": "1.75"
  },
  "exactness": {
    "bmi": "rounded",
    "healthy_weight_min": "rounded",
    "healthy_weight_max": "rounded"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 1
  },
  "inputs": {
    "weight": "70",
    "weight_unit": "kg",
    "height": "175",
    "height_unit": "cm"
  },
  "formula": "BMI = kg / m²; 1 lb = 0.45359237 kg, 1 in = 0.0254 m exactly",
  "references": [
    {
      "title": "CDC: Adult BMI categories",
      "url": "https://www.cdc.gov/bmi/adult-calculator/bmi-categories.html"
    },
    {
      "title": "WHO: Body mass index (BMI) among adults",
      "url": "https://www.who.int/data/gho/data/themes/topics/topic-details/GHO/body-mass-index"
    }
  ],
  "warnings": []
}

Imperial, 5 ft 10 in and 180 lb

Requestcurl
curl https://api.curatedapi.com/v1/calc/health/bmi \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "weight": "180",
    "weight_unit": "lb",
    "height": "5",
    "height_unit": "ft",
    "height_inches": "10"
  }'
200 OKResponse
{
  "calculator": "health/bmi@1",
  "result": {
    "bmi": "25.8",
    "category": "overweight",
    "category_label": "Overweight (pre-obesity)",
    "healthy_weight_min": "128.9",
    "healthy_weight_max": "174.2",
    "weight_kg": "81.6466266",
    "height_m": "1.778"
  },
  "exactness": {
    "bmi": "rounded",
    "healthy_weight_min": "rounded",
    "healthy_weight_max": "rounded"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 1
  },
  "inputs": {
    "weight": "180",
    "weight_unit": "lb",
    "height": "5",
    "height_unit": "ft",
    "height_inches": "10"
  },
  "formula": "BMI = kg / m²; 1 lb = 0.45359237 kg, 1 in = 0.0254 m exactly",
  "references": [
    {
      "title": "CDC: Adult BMI categories",
      "url": "https://www.cdc.gov/bmi/adult-calculator/bmi-categories.html"
    },
    {
      "title": "WHO: Body mass index (BMI) among adults",
      "url": "https://www.who.int/data/gho/data/themes/topics/topic-details/GHO/body-mass-index"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.