Skip to content

IBW API

Compute ideal body weight in kg and lb with optional frame-adjusted logic for coaching and clinical calculators.

Endpoint

  • GET /api/v1/ibw
  • POST /api/v1/ibw/post

Parameters

Name Type Required In Description
height number (>0) Yes Query/Body Height in centimeters.
body_frame string Yes Query/Body small,medium,large.
gender string Yes Query/Body male or female.
formula string No Query hamwi (default) or devine.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Standardize IBW estimation across products.
  • Support formula-specific outputs for clinical and fitness contexts.
  • Add precision and monitoring guidance to raw weight targets.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/ibw?height=176&body_frame=medium&gender=male&formula=hamwi&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ibw/post?formula=devine&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"height":165,"body_frame":"small","gender":"female"}'

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.

{
  "ideal_weight": "69.42 kg",
  "formula": "Hamwi",
  "gender": "Male",
  "body_frame": "Medium",
  "ideal_weight_kg": 69.42,
  "ideal_weight_lb": 153.04,
  "height_cm": 176.0,
  "height_m": 1.76,
  "precision_band": "frame_adjusted",
  "precision_label": "Frame Adjusted",
  "risk_signal": "Reference target suitable for phased planning.",
  "action_plan": ["Set sustainable weekly target range"],
  "monitoring_plan": "Reassess with body composition and performance markers.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "146e3a98a9a8ec1c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ibw",
    "response_language": "en"
  }
}

Product Positioning

Useful for intake forms, digital coaching plans, and healthcare screening workflows needing normalized IBW estimates.

Note

height, body_frame, and gender are mandatory for both GET and POST.