← Back to Documentations

BMI Calculator API

Calculate adult body mass index (BMI) from weight and height using metric units.

Important note: This service is not intended for medical diagnosis, is provided for informational purposes only, and a healthcare professional should be consulted for a definitive evaluation.
Health
V1

V1

/api/v1

First stable version for adult BMI calculations.

GET /api/v1/bmi/calculate Auth Required
Calculate BMI

Calculates adult BMI from weight in kilograms and height in centimeters, then returns the matching CDC adult BMI category.

Authentication
X-Api-Key: your_api_key
Query Parameters
Name Type Required Example Description
weight_kg number required 70 Body weight in kilograms.
height_cm number required 175 Body height in centimeters.
Request Example
GET /api/v1/bmi/calculate?weight_kg=70&height_cm=175
Response Example
{
    "success": true,
    "message": "BMI calculated successfully.",
    "data": {
        "weight_kg": 70,
        "height_cm": 175,
        "height_m": 1.75,
        "bmi": 22.86,
        "category_key": "healthy_weight",
        "category": "Healthy Weight",
        "classification_standard": "CDC adult BMI categories",
        "note": "BMI is a screening measure for adults and is not intended to diagnose disease or replace professional medical advice."
    }
}
Error Response
{
    "success": false,
    "message": "The weight kg field is required.",
    "error_code": "VALIDATION_ERROR"
}