Hypothyroidism (overt / subclinical / central — standalone core)
Standalone chronic-outpatient hypothyroidism — fills MASTER-STATUS §3 gap (previously only existed as cardio HF / myxedema variants). Mandatory phenotype split BEFORE levothyroxine: overt primary (replace, titrate to TSH) vs subclinical (treat-vs-observe by TSH stratum/age/symptoms/TPO-Ab/pregnancy) vs central (DO NOT titrate to TSH; glucocorticoid before levothyroxine; route to endo.hypopituitarism.core.v1) vs non-thyroidal illness (do not treat, retest) vs transient thyroiditis/drug (amiodarone/lithium/checkpoint-inhibitor/TKI/interferon — may be transient). Levothyroxine 1.6 µg/kg/day full replacement; 25–50 µg/day start in elderly/CAD; titrate to TSH q6–8 weeks; pregnancy ~20–30% dose increase at confirmation with trimester-specific targets; combination LT4/LT3 kept as experimental specialist-only branch (no consistent RCT benefit, ratio 13:1–20:1, 3-month stop-rule). Over-replacement avoided (AF/fracture risk). Cross-refs by engine_id (depth-pass-2: 7 real on-disk engines, bidirectional intent + carryover state described in each): endo.hypopituitarism.core.v1 (central — TSH/FT4 + adrenal-axis carryover), endo.myxedema-coma.core.v1 (decompensation — precipitant/glucocorticoid carryover), endo.thyroid-nodule.core.v1 (post-thyroidectomy/RAI replacement + cancer TSH-suppression-target handoff), endo.hyperthyroidism.core.v1 (over-replacement biochemical thyrotoxicosis crossover), endo.pcos.core.v1 (mimic — exclude/treat thyroid before Rotterdam), msk.fibromyalgia.core.v1 (euthyroid symptom mimic of the persistent-symptom branch), endo.osteoporosis.core.v1 (over-replacement bone loss → FRAX). workup.hypothyroidism.branches_to wires hypopituitarism/myxedema-coma/thyroid-nodule/hyperthyroidism. RxCUIs reuse in-repo validated codes: levothyroxine 10582, liothyronine 10583 (both used across cardio.acute-hf.iatrogenic-hypothyroid.v1 and cardio.cardiac-tamponade.myxedema-effusion.v1, ATA-cited). No invented codes; non-pharmacologic actions flagged non_pharm. Manifest is a borrowed placeholder (prisma/seed/manifests/endo.cushing_syndrome.v1.ts) — no dedicated hypothyroidism manifest in this shard (allowed at INTEGRATED). No registry calculator for the SCH treat-threshold beyond calc.tsh_reflex_interpretation; the threshold logic is encoded as severity_triggers + regimen steps + Bayesian notes, and 5 conditional dependencies (TSH-LR | pregnancy / acute-illness / pituitary / assay-interference / nephrotic-proteinuria) are encoded on the calculator entry as data. Declared INTEGRATED (authored at PRODUCTION depth) to avoid strict rxcui/365-day/LOINC promotion gates. Depth-pass-2 (2026-05-17): added 5 PubMed-verified PMIDs — Whickham 20-yr cohort (7641412; raised TSH+thyroid-Ab → hypothyroidism OR 38 [22–65] women / 173 [81–370] men: strongest wired association ≥20), lithium hypothyroidism OR 5.78 (McKnight Lancet 22265699), ICI/PD-1 hypothyroidism OR 1.89–3.81 (28973656, 30861560), nephrotic-syndrome ↑LT4 requirement ~17.6% (28208903, 26280000). 21 PMIDs total, all PubMed-verified (16 on 2026-05-16, 5 on 2026-05-17). Added Step 8 (CKD/nephrotic/malabsorption, race-neutral CKD-EPI-2021) so special-pop branches now = 8 (central, NTIS-defer, transient/drug-quantified, subclinical-threshold, pregnancy, geriatric/CAD-STOPP, nephrotic/CKD, malabsorption); 12 severity triggers; conditional-dependence encoded as data.
Entry points (6)
- lab_abnormalityElevated TSH on screening / opportunistic testing (ATA 2014 Jonklaas; ETA 2013 Pearce)elevated_tsh_on_screen
- lab_abnormalityLow free T4 with low / inappropriately-normal TSH — central pattern (ATA 2014; central CH not always mild, JCEM 2014)low_ft4_with_low_or_normal_tsh
- symptomFatigue / cold intolerance / weight gain / constipation / dry skin (low-specificity cluster) (ATA 2014 Jonklaas)hypothyroid_symptom_cluster
- problem_listEstablished iatrogenic hypothyroidism — post-thyroidectomy / post-RAI titration visit (ATA 2014 Jonklaas)post_thyroidectomy_or_post_rai
- historyPre-conception optimisation or newly pregnant on / needing levothyroxine (ATA 2017 Alexander)preconception_or_pregnant_thyroid
- medicationAmiodarone / lithium / immune-checkpoint inhibitor / TKI / interferon started — drug-induced thyroid dysfunction surveillance (ATA 2014 Jonklaas)thyroid_axis_drug_started
Required inputs (13)
- serum_tshrequiredlab • used at INITIAL_WORKUPPrimary screening + titration analyte for PRIMARY disease; uninformative for titration in central hypothyroidism
- free_t4requiredlab • used at INITIAL_WORKUPDistinguishes overt (low FT4) from subclinical (normal FT4) and is the decisive analyte in central disease (titrate FT4, not TSH)
- tpo_antibodylab • used at BRANCHING_WORKUPTPO-Ab+ identifies autoimmune (Hashimoto) aetiology and ~2× higher SCH→overt progression — drives the treat-vs-observe and pregnancy decisions
- agerequireddemographic • used at CONTEXTAge-specific TSH reference + higher treatment threshold in elderly; oldest-old (>80–85) wait-and-see (TRUST; ETA 2013)
- pregnancy_statusrequireddemographic • used at CONTEXTTrimester-specific TSH targets; ~20–30% levothyroxine dose increase at confirmation; SCH treatment threshold differs (ATA 2017)
- weight_kgrequireddemographic • used at TREATMENTWeight-based full replacement dosing (1.6 µg/kg/day) (ATA 2014)
- cardiac_diseaserequiredhistory • used at CONTEXTCAD / ischaemic heart disease / arrhythmia → start low (25–50 µg/day) and up-titrate slowly to avoid precipitating ischaemia/AF (ATA 2014)
- pituitary_or_hypothalamic_diseaserequiredhistory • used at CONTEXTKnown sellar mass / cranial RT / Sheehan / TBI raises pre-test for CENTRAL hypothyroidism — changes target organ and adrenal-first sequencing
- acute_illness_statusrequiredhistory • used at CONTEXTAcute severe illness causes non-thyroidal illness syndrome (NTIS) — defer interpretation/treatment and retest after recovery
- prior_thyroid_ablation_or_surgeryhistory • used at CONTEXTPost-thyroidectomy / post-RAI = near-certain permanent primary hypothyroidism (pre-test ≈ certainty)
- concurrent_medsrequiredmedication • used at CONTEXTPPI / calcium / iron / fiber / estrogen / malabsorption alter levothyroxine absorption; amiodarone / lithium / checkpoint-inhibitor / TKI / interferon cause thyroid dysfunction
- cortisol_axislab • used at RED_FLAGSIn suspected central hypothyroidism, exclude/treat adrenal insufficiency BEFORE levothyroxine (T4 before cortisol can precipitate adrenal crisis)
- myxedema_decompensation_featuresrequiredsymptom • used at RED_FLAGSHypothermia, depressed consciousness, hypoventilation, bradycardia, hyponatremia — screen for myxedema coma → escalate OUT to the acute engine
12-phase flow (12)
- 1FRAMEHypothyroidism is a biochemical state requiring a mandatory phenotype split BEFORE levothyroxine: overt primary vs subclinical vs central vs non-thyroidal illness vs transient (thyroiditis/drug). Treatment target, treat-threshold, and safety steps differ by phenotype (ATA 2014 Jonklaas)inputs: serum_tsh, free_t4advance: Scope set to chronic ambulatory hypothyroidism with the 5-way phenotype frame explicit
- 2ENTRYElevated TSH on screen; low FT4 with low/normal TSH (central); low-specificity symptom cluster; established iatrogenic titration visit; pre-conception/pregnancy; thyroid-axis drug started (ATA 2014; ATA 2017; ETA 2013)inputs: serum_tsh, free_t4advance: Engine entered via a recognised trigger
- 3CONTEXTCapture age (age-specific reference + elderly threshold), pregnancy/pre-conception status, weight (dosing), cardiac disease (start-low), known pituitary/hypothalamic disease (central pre-test), acute-illness status (NTIS), prior thyroid ablation/surgery (iatrogenic certainty), absorption-interacting and thyroid-toxic medications (ATA 2014; ATA 2017; ETA 2013)inputs: age, pregnancy_status, cardiac_disease, pituitary_or_hypothalamic_disease, acute_illness_status, concurrent_medsadvance: Demographic, cardiac, pituitary, illness and medication context fully captured
- 4RED_FLAGSMyxedema decompensation (hypothermia, depressed consciousness, hypoventilation, bradycardia, hyponatremia) → escalate OUT to endo.myxedema-coma.core.v1. Suspected central hypothyroidism with possible adrenal insufficiency → exclude/treat adrenal crisis and give glucocorticoid BEFORE levothyroxine; route to endo.hypopituitarism.core.v1 (ATA 2014; central CH not always mild — JCEM 2014)inputs: myxedema_decompensation_features, cortisol_axisactions: workup.hypothyroidismadvance: Myxedema coma and adrenal-crisis-in-central screened and escalated/routed if present
- 5INITIAL_WORKUPSerum TSH with reflex free T4 is the core test; the TSH/FT4 pattern is the decisive pivot: high TSH+low FT4 → overt primary; high TSH+normal FT4 → subclinical; low/normal TSH+low FT4 → central; low FT3/FT4 + low/normal TSH in acute illness → NTIS. Confirm a persistently abnormal TSH (repeat with TPO-Ab after 2–3 months for SCH) (ATA 2014 Jonklaas; ETA 2013 Pearce)inputs: serum_tsh, free_t4actions: panel.tsh, panel.thyroid, calc.tsh_reflex_interpretation, workup.hypothyroidismadvance: TSH/FT4 pattern assigned to a phenotype and persistence confirmed
- 6BRANCHING_WORKUPTPO-Ab for autoimmune aetiology + progression risk (~2× if positive); pregnancy → re-interpret against trimester-specific TSH reference; suspected central → full anterior pituitary axis + adrenal axis (route to hypopituitarism); transient suspicion (post-partum 2–12 mo, sub-acute thyroiditis, amiodarone/lithium/checkpoint-inhibitor/TKI/interferon) → characterise as transient vs permanent; associated lipid derangement screen (ATA 2014; ATA 2017; ETA 2013)inputs: tpo_antibody, pregnancy_status, pituitary_or_hypothalamic_disease, concurrent_medsactions: panel.thyroid, panel.lipid, workup.hypothyroidismadvance: Aetiology, autoimmune status, central-axis and transient-vs-permanent characterised
- 7DIFFERENTIALMECE terminal split: overt primary hypothyroidism (Hashimoto / iatrogenic / iodine / congenital) vs subclinical primary vs central (secondary/tertiary) hypothyroidism vs non-thyroidal illness syndrome vs transient thyroiditis / drug-induced dysfunction. The TSH/FT4 pattern conditional on pregnancy / illness / pituitary status is decisive (ATA 2014 Jonklaas)inputs: serum_tsh, free_t4, tpo_antibodyadvance: Terminal phenotype + aetiology assigned
- 8RISK_STRATIFICATIONSubclinical treat-vs-observe engine: TSH >10 → treat (CHD mortality HR 1.58, 95% CI 1.10–2.27, Floriani/Rodondi); TSH 4.5–10 + symptoms → time-limited LT4 trial, stop if no benefit at 3–4 mo (Feller QoL SMD −0.11, 95% CI −0.25 to 0.03); age >65–70 → higher threshold/observe (TRUST null); oldest-old >80–85 → wait-and-see; pregnancy / TPO-Ab+ → lower threshold to treat (untreated pregnancy-loss RR 2.01 → treated OR 0.55) (ETA 2013 Pearce; TRUST Stott NEJM 2017; ATA 2017 Alexander)inputs: serum_tsh, free_t4, age, pregnancy_status, tpo_antibodyactions: calc.tsh_reflex_interpretationadvance: Treat-vs-observe decision made with the threshold rule that applies to this stratum
- 9TREATMENTOvert primary: levothyroxine 1.6 µg/kg/day; elderly/CAD start 25–50 µg/day and up-titrate slowly; titrate to TSH at q6–8-week intervals; manage absorption interactions (separate from PPI/calcium/iron/fiber by 4 h, account for estrogen/malabsorption). Central: titrate to mid-normal FT4 NOT TSH, and only AFTER glucocorticoid if adrenal insufficiency possible. Subclinical: per the risk-stratification threshold. Pregnancy: increase dose ~20–30% as soon as confirmed, trimester-specific TSH targets. Persistent symptoms despite normal TSH: address chronic-disease support / associated autoimmune disease; LT4/LT3 combination is EXPERIMENTAL specialist-only (ratio 13:1–20:1, stop at 3 mo if no benefit). NTIS / transient: do NOT treat; retest after recovery / off insult. Myxedema coma → endo.myxedema-coma.core.v1 (ATA 2014 Jonklaas; ATA 2017 Alexander; 2012 ETA + 2021 ATA/BTA/ETA combination consensus)inputs: weight_kg, serum_tsh, free_t4, pregnancy_status, cardiac_diseaseactions: panel.tshadvance: Phenotype-appropriate levothyroxine plan (or deliberate no-treatment for NTIS/observed-SCH) documented
- 10DISPOSITIONAlmost all managed outpatient. Route central hypothyroidism → endo.hypopituitarism.core.v1 (full axis + adrenal-first). Escalate myxedema decompensation → endo.myxedema-coma.core.v1 (ED/ICU). Pregnant patients co-managed with obstetrics (ATA 2014; ATA 2017)inputs: pituitary_or_hypothalamic_disease, myxedema_decompensation_featuresadvance: Setting set and central/myxedema routing executed
- 11MONITORINGPrimary: recheck TSH ~6–8 weeks after every dose change until stable, then every 6–12 months. Central: monitor FT4 (mid-normal target) — TSH is uninformative. Pregnancy: TSH approximately every 4 weeks in the first half then at least once mid-second/third trimester. Watch for over-replacement (suppressed TSH → AF risk HR 1.45 high-normal FT4; subclinical-hyperthyroid hip-fracture HR 1.36) (ATA 2014 Jonklaas; ATA 2017 Alexander; ETA 2013 Pearce)inputs: serum_tsh, free_t4, pregnancy_statusactions: panel.tsh, panel.thyroidadvance: Monitoring cadence individualised by phenotype and pregnancy status; over-replacement excluded
- 12FOLLOWUPLifelong replacement for permanent primary and central disease (transient may be weaned and retested). Reinforce adherence + consistent timing + absorption-interaction counselling; pre-conception planning for women of reproductive age (optimise pre-pregnancy, plan the ~20–30% bump); annual TSH once stable; reassess persistent-symptom patients (chronic-disease support, exclude associated autoimmune disease) before any combination trial (ATA 2014 Jonklaas; ATA 2017 Alexander; 2021 ATA/BTA/ETA combination consensus)inputs: pregnancy_statusactions: panel.tshadvance: Lifelong / wean plan, adherence counselling and pre-conception plan booked