Daily Calorie Needs API Documentation

V1

/api/v1

First stable version for adult daily calorie maintenance estimates.

POST /api/v1/health/daily-calorie-needs Auth Required

Estimate Daily Calorie Needs

Estimates adult daily maintenance calories using age, body size, gender, and activity level.

Authentication

X-Api-Key: your_api_key

Body Parameters

Name	Type	Required	Example	Description
`age_years`	integer	required	`30`	Adult age in years. Supported range: 19-120.
`gender`	string	required	`male`	Accepted values include male or female.
`weight_kg`	number	required	`80`	Body weight in kilograms.
`height_cm`	number	required	`180`	Body height in centimeters.
`activity_level`	string	required	`inactive`	Allowed values: inactive, low_active, active, very_active.

Request Example

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

{
  "age_years": 30,
  "gender": "male",
  "weight_kg": 80,
  "height_cm": 180,
  "activity_level": "inactive"
}

Response Example

{
    "success": true,
    "message": "Daily calorie needs estimated successfully.",
    "data": {
        "age_years": 30,
        "gender": "male",
        "weight_kg": 80,
        "height_cm": 180,
        "height_m": 1.8,
        "activity_level": "inactive",
        "physical_activity_coefficient": 1,
        "estimated_daily_calories_kcal": 2620,
        "estimated_daily_calories_kj": 10965,
        "goal": "weight_maintenance",
        "classification_standard": "National Academies estimated energy requirement for adults",
        "note": "This estimate is intended for healthy adults and reflects maintenance calories, not a weight-loss or medical nutrition prescription."
    }
}

Error Response

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