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
- Version 1
- MCP tool
calc_health_bmi - Try it in the browser
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).
| Input | Type | Description |
|---|---|---|
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.
| Result | Type | Description |
|---|---|---|
bmi | decimal (string) | Body mass index in kg/m². Unit: kg/m². |
category | string | Weight category code: underweight, healthy_weight, overweight, obesity_class_1, obesity_class_2 or obesity_class_3. |
category_label | string | Weight category in words. |
healthy_weight_min | decimal (string) | Lowest weight in the healthy band (BMI 18.5) for this height, in weight_unit. |
healthy_weight_max | decimal (string) | Weight at BMI 25 for this height, in weight_unit (the healthy band ends just below it). |
weight_kg | string | Weight in kilograms, exact (not rounded). |
height_m | string | Height in metres, exact (not rounded). |
Examples
Metric
curl https://api.curatedapi.com/v1/calc/health/bmi \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"weight": "70",
"height": "175"
}'
{
"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
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"
}'
{
"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.