Skip to content

BSA Calculator API

Compute body surface area (BSA) and return both the selected formula result and cross-formula comparison values.

Endpoint

  • GET /api/v1/bsa-calculator
  • POST /api/v1/bsa-calculator/post

Parameters

Name Type Required In Description
weight number Yes Query/Body Weight (kg metric, lb imperial).
height number Yes Query/Body Height (cm metric, in imperial).
unit string (metric,imperial) No Query/Body Input unit mode. Default metric.
formula string No Query/Body du_bois,mosteller,haycock,gehan_george,fujimoto.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Standardize BSA for dosing and clinical calculations.
  • Compare formula variability in one response.
  • Build safer decision-support dashboards with context.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/bsa-calculator?weight=78&height=175&unit=metric&formula=mosteller&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/bsa-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weight":78,"height":175,"unit":"metric","formula":"mosteller"}'

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.

{
  "bsa_m2": 1.9467,
  "formula_used": "mosteller",
  "formula_comparison_m2": {
    "du_bois": 1.9442,
    "mosteller": 1.9467,
    "haycock": 1.9505,
    "gehan_george": 1.9549,
    "fujimoto": 1.9213
  },
  "bsa_band": "moderate",
  "bsa_band_label": "Moderate",
  "clinical_context": "Mosteller is commonly used in bedside workflows.",
  "action_plan": ["Cross-check formula if high-risk dosing is planned"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "7ab38f5d39a4d702",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "bsa_calculator",
    "response_language": "en"
  }
}

Market Positioning

Useful for oncology dosing support, perioperative calculators, and clinical decision SaaS.

Note

formula validation is strict; unsupported formula names return HTTP 400.