{"openapi":"3.1.0","info":{"title":"Clinical Calculator API","version":"1.0.0","description":"Standard clinical and nursing calculators as an API — the everyday medical maths, computed locally. The bsa endpoint computes body surface area from weight and height by the Mosteller, Du Bois and Haycock formulas (used for chemotherapy and drug dosing). The egfr endpoint estimates kidney function from serum creatinine, age and sex using the race-free CKD-EPI 2021 equation, and the Cockcroft-Gault creatinine clearance when a weight is given (creatinine in mg/dL or µmol/L). The drip-rate endpoint computes an IV infusion's drops per minute and millilitres per hour from the volume, time and drop factor. The gcs endpoint scores the Glasgow Coma Scale from its eye, verbal and motor components and gives the severity band. Everything is computed locally and deterministically, so it is instant and private. INFORMATIONAL ONLY — not medical advice; always verify with clinical judgement and approved tools. Ideal for healthcare and nursing apps, clinical decision-support prototypes, medical education, and EHR tooling. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. This is clinical maths; for drug reference data use a drug API and for BMI, BMR and calories use a health-calculator API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/medcalc-api","description":"oanor gateway"}],"tags":[{"name":"Clinical"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/bsa":{"get":{"operationId":"get_v1_bsa","tags":["Clinical"],"summary":"Body surface area","description":"","parameters":[{"name":"weight","in":"query","required":true,"description":"kg","schema":{"type":"string"},"example":"70"},{"name":"height","in":"query","required":true,"description":"cm","schema":{"type":"string"},"example":"170"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bsa_m2":{"du_bois":1.8097,"haycock":1.8257,"mosteller":1.8181},"height_cm":170,"weight_kg":70,"disclaimer":"informational only, not medical advice"},"meta":{"timestamp":"2026-06-03T17:42:02.208Z","request_id":"6c6831dc-59e3-4eb7-b98b-aaacffd16e90"},"status":"ok","message":"Body surface area","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/drip-rate":{"get":{"operationId":"get_v1_drip_rate","tags":["Clinical"],"summary":"IV infusion drip rate","description":"","parameters":[{"name":"volume","in":"query","required":true,"description":"mL","schema":{"type":"string"},"example":"1000"},{"name":"hours","in":"query","required":false,"description":"or minutes","schema":{"type":"string"},"example":"8"},{"name":"drop_factor","in":"query","required":false,"description":"gtt/mL (default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"time_min":480,"volume_ml":1000,"disclaimer":"informational only, not medical advice","ml_per_hour":125,"drops_per_minute":41.667,"drop_factor_gtt_ml":20,"drops_per_minute_rounded":42},"meta":{"timestamp":"2026-06-03T17:42:02.337Z","request_id":"3688c346-68c0-46f7-aba4-1bdacfbda02f"},"status":"ok","message":"IV drip rate","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/egfr":{"get":{"operationId":"get_v1_egfr","tags":["Clinical"],"summary":"eGFR + creatinine clearance","description":"","parameters":[{"name":"creatinine","in":"query","required":true,"description":"Serum creatinine","schema":{"type":"string"},"example":"1.0"},{"name":"creatinine_unit","in":"query","required":false,"description":"mg/dL|umol/L","schema":{"type":"string"},"example":"mg/dL"},{"name":"age","in":"query","required":true,"description":"years","schema":{"type":"string"},"example":"50"},{"name":"sex","in":"query","required":true,"description":"male|female","schema":{"type":"string"},"example":"male"},{"name":"weight","in":"query","required":false,"description":"kg (Cockcroft-Gault)","schema":{"type":"string"},"example":"70"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"age":50,"sex":"male","crcl_unit":"mL/min","egfr_unit":"mL/min/1.73m²","disclaimer":"informational only, not medical advice","creatinine_mg_dl":1,"egfr_ckd_epi_2021":91.69,"creatinine_clearance_cockcroft_gault":87.5},"meta":{"timestamp":"2026-06-03T17:42:02.441Z","request_id":"c62ddb69-ffc1-4613-a8e5-fab5f8ba1a2b"},"status":"ok","message":"eGFR","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/gcs":{"get":{"operationId":"get_v1_gcs","tags":["Clinical"],"summary":"Glasgow Coma Scale","description":"","parameters":[{"name":"eye","in":"query","required":true,"description":"1-4","schema":{"type":"string"},"example":"4"},{"name":"verbal","in":"query","required":true,"description":"1-5","schema":{"type":"string"},"example":"5"},{"name":"motor","in":"query","required":true,"description":"1-6","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"eye":4,"max":15,"motor":6,"total":15,"verbal":5,"severity":"minor (13-15)","disclaimer":"informational only, not medical advice"},"meta":{"timestamp":"2026-06-03T17:42:02.549Z","request_id":"6178e75f-e9d3-465a-948d-cffeb4cc00bb"},"status":"ok","message":"Glasgow Coma Scale","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Clinical Calculator API","notes":"INFORMATIONAL ONLY — not medical advice. eGFR uses CKD-EPI 2021 (race-free). BSA in m². Nothing is stored.","version":"v1","endpoints":[{"path":"/v1/bsa","params":{"height":"cm","weight":"kg"},"returns":"body surface area (Mosteller, Du Bois, Haycock)"},{"path":"/v1/egfr","params":{"age":"years","sex":"male|female","weight":"kg (for Cockcroft-Gault)","creatinine":"serum creatinine","creatinine_unit":"mg/dL|umol/L"},"returns":"eGFR and creatinine clearance"},{"path":"/v1/drip-rate","params":{"volume":"mL","minutes":"or hours","drop_factor":"gtt/mL (default 20)"},"returns":"drops per minute and mL/hour"},{"path":"/v1/gcs","params":{"eye":"1-4","motor":"1-6","verbal":"1-5"},"returns":"the GCS total and severity"},{"path":"/v1/meta","params":[],"returns":"this document"}],"description":"Standard clinical and nursing calculators as an API — the everyday medical maths, computed locally. The bsa endpoint computes body surface area from weight and height by the Mosteller, Du Bois and Haycock formulas (used for chemotherapy and drug dosing). The egfr endpoint estimates kidney function from serum creatinine, age and sex using the race-free CKD-EPI 2021 equation, and the Cockcroft-Gault creatinine clearance when a weight is given (creatinine in mg/dL or µmol/L). The drip-rate endpoint computes an IV infusion's drops per minute and millilitres per hour from the volume, time and drop factor. The gcs endpoint scores the Glasgow Coma Scale from its eye, verbal and motor components and gives the severity band. Everything is computed locally and deterministically, so it is instant and private. INFORMATIONAL ONLY — not medical advice; verify with clinical judgement and approved tools. Ideal for healthcare and nursing apps, clinical decision-support prototypes, medical education, and EHR tooling. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. This is clinical maths; for drug reference data use a drug API and for BMI/BMR/calories use a health-calculator API."},"meta":{"timestamp":"2026-06-03T17:42:02.659Z","request_id":"7d5dc415-9e38-46bd-a4c6-4d63d21e7ab6"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8835,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1035,"monthly_call_quota":18450,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3025,"monthly_call_quota":234500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6825,"monthly_call_quota":1215000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/medcalc-api"}