← Back to Documentations

Ideal Weight API

Estimate an adult healthy weight range from height using the healthy BMI range reference.

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 ideal weight range estimation.

POST /api/v1/health/ideal-weight Auth Required
Calculate Ideal Weight Range

Estimates an adult healthy weight range from height and returns the lower and upper limits in kilograms.

Authentication
X-Api-Key: your_api_key
Body Parameters
Name Type Required Example Description
height_cm number required 175 Adult height in centimeters.
gender string required male Accepted values include male or female. The range is still calculated from the adult healthy BMI reference.
Request Example
POST /api/v1/health/ideal-weight
Content-Type: application/json
X-Api-Key: your_api_key

{
  "height_cm": 175,
  "gender": "male"
}
Response Example
{
    "success": true,
    "message": "Ideal weight range calculated successfully.",
    "data": {
        "height_cm": 175,
        "height_m": 1.75,
        "gender": "male",
        "estimated_ideal_weight_range_kg": {
            "lower_limit_kg": 56.66,
            "upper_limit_kg": 76.26
        },
        "lower_limit_kg": 56.66,
        "upper_limit_kg": 76.26,
        "classification_standard": "CDC adult healthy BMI range",
        "note": "This estimated range is based on the adult healthy BMI range of 18.5 to 24.9. For adults, this BMI-based range remains the same regardless of gender."
    }
}
Error Response
{
    "success": false,
    "message": "The height cm field is required.",
    "error_code": "VALIDATION_ERROR"
}