Skip to content

DWI API

Calculate recommended daily hydration target in ounces or liters with contextual risk and action outputs.

Endpoint

  • GET /api/v1/dwi
  • POST /api/v1/dwi/post

Parameters

Name Type Required In Description
weight number Yes Query/Body Body weight (expected in pounds for model basis).
activity_level string Yes Query/Body sedentary,lightly_active,moderately_active,very_active,extra_active.
climate string Yes Query/Body normal,hot,cold.
unit string No Query/Body Output unit: ounces or liters.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Personalize hydration planning for lifestyle context.
  • Support adherence coaching with clear intake targets.
  • Add climate-aware hydration intelligence to wellness apps.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/dwi?weight=180&activity_level=moderately_active&climate=hot&unit=liters&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/dwi/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weight":180,"activity_level":"moderately_active","climate":"hot","unit":"liters"}'

Response Example

Info

The response example below is for demonstration purposes only. Make a live request to this endpoint to receive the full, real-time, and potentially richer JSON structure.

{
  "water_intake": 3.72,
  "unit": "liters",
  "daily_water_target_oz": 125.8,
  "daily_water_target_liters": 3.72,
  "input_profile": {
    "weight": 180.0,
    "activity_level": "moderately_active",
    "climate": "hot"
  },
  "hydration_band": "higher",
  "hydration_band_label": "Higher",
  "risk_signal": "Hydration demand is elevated.",
  "action_plan": ["Spread intake across day", "Pair water with electrolytes when needed"],
  "monitoring_plan": "Monitor urine color and performance consistency.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "dd7330d32ca5701a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "dwi",
    "response_language": "en"
  }
}

Market Fit

Great for habit apps, fitness coaching products, and preventive-care wellness platforms.

Note

unit defaults to ounces if omitted or unsupported.