Skip to content

QTc Calculator API

Calculate corrected QT metrics from ECG timing inputs and return interpretation support for risk workflows.

Endpoint

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

Parameters

Name Type Required In Description
qt number (>0) Yes Query/Body QT interval (milliseconds).
rr number (>0) Conditionally Query/Body RR interval (seconds). Required if heart_rate not provided.
heart_rate number (>0) Conditionally Query/Body Heart rate bpm. Used to derive RR when RR omitted.
sex string No Query/Body male or female for sex-specific thresholds.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Return 4 QTc formulas for clinical-context flexibility.
  • Add interpretation and action fields for triage workflows.
  • Support ECG-driven decision support layers.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/qtc-calculator?qt=410&rr=0.82&sex=female&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/qtc-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"qt":430,"heart_rate":78,"sex":"male"}'

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.

{
  "qt_ms": 410.0,
  "rr_s": 0.82,
  "heart_rate_bpm": 73.17,
  "qtc_bazett_ms": 452.81,
  "qtc_fridericia_ms": 438.34,
  "qtc_framingham_ms": 437.72,
  "qtc_hodges_ms": 432.8,
  "sex": "female",
  "interpretation": "Borderline",
  "recommendation": "Repeat ECG and review contributing factors.",
  "interpretation_protocol": {"priority": "clinical review"},
  "immediate_actions": ["Check medications and electrolytes"],
  "monitoring_plan": ["Repeat as indicated by care protocol"],
  "escalation_flags": [],
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "d145be0c2ea09f19", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "qtc_calculator", "response_language": "en"}
}

Product Positioning

Relevant for clinical-support apps, remote monitoring, and enterprise cardiometabolic platforms.

Note

Provide either rr or heart_rate; if both are missing API returns HTTP 400.