ClinDose API
Add ClinDose calculations to the systems clinicians already use: EHRs such as Epic, Oracle Health (Cerner), and MEDITECH, pharmacy and dental software, mobile apps, and teaching platforms. Any system that can make an HTTPS request can use it.
ClinDose is not affiliated with or endorsed by the EHR vendors named. Connecting inside a specific EHR is set up with each organization's own integration team.
Same engine as the websiteThe API and clindose.com run identical, tested code, so results always match.
Shows its workEvery response includes the worked calculation, warnings, and formula version for audit trails.
No patient identifiersSend only the numbers a formula needs. Nothing is stored.
Launching from inside the EHR? See SMART on FHIR integration
Quick start
curl -X POST https://clindose.com/api/v1/calculate/crcl \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sex":"male","ageYears":68,"weightLb":200,"heightIn":68,"scrMgDl":1.4}'{
"ok": true,
"calculator": "crcl",
"version": "0.2.0",
"primary": { "label": "BMI-guided estimate", "display": "55.2", "unit": "mL/min", ... },
"results": [
{ "label": "Actual body weight", "display": "64.8", "unit": "mL/min" },
{ "label": "Ideal body weight", "display": "48.9", "unit": "mL/min" },
{ "label": "Adjusted body weight", "display": "55.2", "unit": "mL/min" }
],
"worksheet": [ { "label": "...", "expression": "...", "result": "..." } ],
"warnings": [],
"note": "Estimates creatinine clearance; not indexed to BSA. ..."
}const res = await fetch("https://clindose.com/api/v1/calculate/bsa", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer YOUR_API_KEY" },
body: JSON.stringify({ heightCm: 180, weightKg: 80 }),
});
const data = await res.json();
console.log(data.primary.display, data.primary.unit); // 2.00 m²Endpoints
GET /api/v1/calculators- Public catalog: every calculator with its input schema, version, and specialties.
POST /api/v1/calculate/{id}- Runs a calculator. Requires
Authorization: Bearer YOUR_API_KEY. Send JSON in the body; requests without a valid key receive 401. GET /api/health- Service status.
Authentication
Every calculation request needs an API key issued by ClinDose. Keys are tied to a licensed organization and must be kept on your server, never in a public web page or app bundle.
Shared patient inputs
| Field | Meaning | Alternates |
|---|---|---|
sex | "male" or "female" | |
ageYears | Age in years | age |
weightKg | Actual body weight, kg | weightLb |
heightCm | Height, cm | heightIn |
scrMgDl | Serum creatinine, mg/dL | scrUmolL |
Available calculators (62)
Calculator-specific inputs use the field names below; choices take the option value and checkboxes take true or false. The full schema for each is in GET /api/v1/calculators.
| ID | Calculator | Inputs | Version |
|---|---|---|---|
crcl | Creatinine clearance (Cockcroft–Gault) | sex, ageYears, weightKg, scrMgDl, heightCm | 0.2.0 |
ibw | Ideal body weight (Devine) | sex, heightCm, weightKg | 0.1.0 |
adjbw | Adjusted body weight | sex, heightCm, weightKg | 0.1.0 |
bmi | Body mass index | heightCm, weightKg | 0.1.0 |
bsa | Body surface area (Mosteller) | heightCm, weightKg | 0.1.0 |
vanco-auc | Vancomycin AUC dosing | weightKg, mode, crcl, targetAuc, vdPerKg, loadPerKg, dose, tau, tinf, peak, tpeak, trough, ttrough | 0.1.0 |
aminoglycosides | Aminoglycoside dosing (gentamicin, tobramycin, amikacin) | sex, heightCm, weightKg, drug, method, crcl, targetPeak, targetTrough, dose, tau, tinf, peak, tpeak, trough, ttrough | 0.1.0 |
egfr | eGFR (CKD-EPI 2021, creatinine) | sex, ageYears, scrMgDl | 0.1.0 |
schwartz | Bedside Schwartz eGFR (pediatric) | heightCm, scrMgDl | 0.1.0 |
fena | Fractional excretion of sodium (FENa) | una, pna, ucr, scrMgDl | 0.1.0 |
feurea | Fractional excretion of urea (FEUrea) | uurea, purea, ucr, scrMgDl | 0.1.0 |
anion-gap | Anion gap (with albumin correction) | na, cl, hco3, alb | 0.1.0 |
winters | Winter's formula (expected PaCO₂) | hco3, paco2 | 0.1.0 |
osmolality | Calculated osmolality and osmolal gap | na, glu, bun, etoh, meas | 0.1.0 |
sodium-correction | Sodium correction for hyperglycemia | na, glu | 0.1.0 |
free-water | Free water deficit | sex, ageYears, weightKg, na | 0.1.0 |
calcium | Corrected calcium (albumin) | ca, alb | 0.1.0 |
chadsvasc | CHA₂DS₂-VASc score | age, sex, chf, htn, stroke, vasc, dm | 0.1.0 |
hasbled | HAS-BLED score | h, renal, liver, s, b, l, e, d, alc | 0.1.0 |
heart | HEART score for chest pain | h, e, a, r, t | 0.1.0 |
wells-pe | Wells criteria for pulmonary embolism | dvt, likely, hr, immob, prior, hemo, ca | 0.1.0 |
perc | PERC rule for pulmonary embolism | age, hr, sat, leg, hemo, surg, prior, horm | 0.1.0 |
wells-dvt | Wells criteria for DVT | ca, par, bed, tend, leg, calf, pit, coll, prior, alt | 0.1.0 |
curb65 | CURB-65 for pneumonia severity | c, u, r, b, a | 0.1.0 |
qsofa | qSOFA | rr, ms, sbp | 0.1.0 |
gcs | Glasgow Coma Scale | e, v, m | 0.1.0 |
map | Mean arterial pressure | sbp, dbp | 0.1.0 |
shock-index | Shock index | hr, sbp | 0.1.0 |
qtc | Corrected QT interval (QTc) | qt, hr | 0.1.0 |
aa-gradient | A–a oxygen gradient and P/F ratio | ageYears, fio2, pao2, paco2, patm | 0.1.0 |
pbw-tidal | Predicted body weight and tidal volume | sex, heightCm | 0.1.0 |
child-pugh | Child-Pugh score | bili, alb, inr, asc, enc | 0.1.0 |
meld-na | MELD-Na | scrMgDl, bili, inr, na, dialysis | 0.1.0 |
mme | Morphine milligram equivalents (MME) | drug, dose | 0.1.0 |
steroid | Corticosteroid dose conversion | from, dose | 0.1.0 |
drip | IV drip rate | vol, time, df | 0.1.0 |
infusion | Weight-based infusion rate | dose, weightKg, amt, bag | 0.1.0 |
dilution | Dilution (C1V1 = C2V2) | c1, c2, v2 | 0.1.0 |
peds-dose | Weight-based dose (mg/kg) | weightKg, mgkg, freq, max, conc | 0.1.0 |
days-supply | Days supply | qty, per, freq | 0.1.0 |
carboplatin | Carboplatin dose (Calvert) | auc, gfr | 0.1.0 |
dental-la | Maximum dental local anesthetic dose | weightKg, drug | 0.1.0 |
local-anesthetic | Maximum local anesthetic dose (medical) | weightKg, drug, pct | 0.1.0 |
maint-fluids | Maintenance IV fluids (4-2-1 rule) | weightKg | 0.1.0 |
ebv-abl | Estimated blood volume and allowable blood loss | weightKg, grp, hi, hf | 0.1.0 |
parkland | Parkland formula for burns | weightKg, tbsa | 0.1.0 |
o2-tank | Oxygen cylinder duration | cyl, psi, flow | 0.1.0 |
mifflin | Resting energy expenditure (Mifflin–St Jeor) | sex, ageYears, heightCm, weightKg | 0.1.0 |
lbw | Lean body weight (Janmahasatian) | sex, heightCm, weightKg | 0.1.0 |
due-date | Due date and gestational age (from LMP) | lmp, cycle | 0.1.0 |
bishop | Bishop score | dil, eff, sta, con, pos | 0.1.0 |
apls-weight | Pediatric weight estimate (APLS) | age | 0.1.0 |
vertex | Vertex distance conversion | f, d | 0.1.0 |
transpose | Cylinder transposition and spherical equivalent | s, c, ax | 0.1.0 |
accommodation | Expected amplitude of accommodation (Hofstetter) | ageYears, meas | 0.1.0 |
bolton | Bolton tooth-size analysis | mx12, md12, mx6, md6 | 0.1.0 |
anc | Absolute neutrophil count | wbc, segs, bands | 0.1.0 |
ldl | LDL cholesterol (Friedewald) | tc, hdl, tg | 0.1.0 |
eag | A1c to estimated average glucose | a1c | 0.1.0 |
diag-stats | Diagnostic test statistics (2 × 2) | tp, fp, fn, tn | 0.1.0 |
nnt | Number needed to treat | cer, eer | 0.1.0 |
rule-of-nines | Burn TBSA (adult rule of nines) | head, la, ra, at, pt, ll, rl, per | 0.1.0 |
Plans
EvaluationTime-limited test key for integration and evaluation, with limited volume. Not for production patient care.
InstitutionalPaid license for hospitals, health systems, and clinics, with production volume, an API key, uptime commitments, and support.
Vendor and partnerPaid license for EHR, pharmacy, dental, and app vendors embedding ClinDose in their products.
The clindose.com website stays free for individual clinicians. To discuss an institutional or vendor license, contact api@clindose.com.
Results are decision support for licensed professionals and must be verified independently. ClinDose is in development preview and not yet validated for patient care.