Daily Water Intake API Documentation

V1

/api/v1

First stable version for daily water intake estimates.

POST /api/v1/health/daily-water-intake Auth Required

Estimate Daily Water Intake

Estimates total daily water intake and separates the approximate contributions from beverages and food moisture.

Authentication

X-Api-Key: your_api_key

Body Parameters

Name	Type	Required	Example	Description
`age_years`	integer	required	`30`	Age in years. Supported range: 14-120.
`gender`	string	required	`male`	Accepted values include male or female.
`is_pregnant`	boolean	optional	`false`	Optional life-stage flag for ages 14 through 50.
`is_breastfeeding`	boolean	optional	`false`	Optional life-stage flag for ages 14 through 50.

Request Example

POST /api/v1/health/daily-water-intake
Content-Type: application/json
X-Api-Key: your_api_key

{
  "age_years": 30,
  "gender": "male"
}

Response Example

{
    "success": true,
    "message": "Daily water intake estimated successfully.",
    "data": {
        "age_years": 30,
        "gender": "male",
        "is_pregnant": false,
        "is_breastfeeding": false,
        "life_stage_group": "male_19_plus",
        "estimated_total_water_liters_per_day": 3.7,
        "estimated_total_water_ml_per_day": 3700,
        "estimated_total_water_cups_per_day": 15.6,
        "estimated_from_beverages_liters_per_day": 3,
        "estimated_from_beverages_cups_per_day": 12.7,
        "estimated_from_food_liters_per_day": 0.7,
        "estimated_from_food_ml_per_day": 700,
        "classification_standard": "National Academies adequate intake for total water",
        "note": "This estimate refers to total daily water intake from drinking water, other beverages, and food moisture. Higher intake may be needed during hot weather, exercise, fever, vomiting, or diarrhea."
    }
}

Error Response

{
    "success": false,
    "message": "The age years field is required.",
    "error_code": "VALIDATION_ERROR"
}