Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P16 KE-P16 · inpatient visit

One row per condition family: what the record supports under the published definition, what the note states, the visit's diagnosis entries, and an assessment. Codes are coded from the signed documentation; the software never assigns one.

Note: unsigned draft

Side-panel conditions check FRUN-00016 · front-engine 1.2 · replay 28db92e3b9e45146…

Library check LRUN-00016 · library_default_set@1.1 · library-engine 1.1 · replay 8e01f667888f95ce… · Data (JSON)

Core definitions 4

Core definitions: condition families for this encounter (4)
Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
Kidney disease stage (filtering rate)
measured · side-panel condition

front_kidney_stage_wording@1.0 Draft · pending review

Record meets: Chronic kidney disease stage 3b

  • Filtering rate 40.6 on 2026-04-25 (G3b range) and 39.3 on 2026-08-03 (G3b range) · L-0035
Options and what the record shows
  • Chronic kidney disease stage 1 · needs filtering rate 90 or above with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · not met
  • Chronic kidney disease stage 2 · needs filtering rate 60-89 with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · not met
  • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · not met
  • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · met
  • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · not met
  • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03 (G3b range) · not met
Citation

Kidney disease stage wording by filtering rate, with the albumin-to-creatinine category (options for the clinician)

front_kidney_stage_wording@1.0

In our words: Kidney disease by filtering rate: below 60 on results at least 3 months apart; or urine albumin-to-creatinine ratio 30 mg/g or higher on two tests at least 3 months apart. Stage by filtering rate: G1 90 or above; G2 60-89; G3a 45-59; G3b 30-44; G4 15-29; G5 below 15 (G1 and G2 also need a marker of kidney damage). Albumin-to-creatinine category: A1 below 30, A2 30-299, A3 300 mg/g or above. The filtering rate is estimated with the 2021 race-free creatinine equation.

Decreased eGFR <60 mL/min/1.73 m2 (GFR categories G3a-G5) for ≥3 months

Department of Veterans Affairs and Department of Defense, VA/DoD Clinical Practice Guideline for the Primary Care Management of Chronic Kidney Disease, Provider Summary (Version 5.0) (2025) · Sidebar 6 'Criteria for CKD' (PDF page 16; printed page 13 of 37). Do not use Sidebar 9 (a reproduced third-party figure) · source

Licence: U.S. government work (public domain); filtering-rate stage bands (90, 60, 45, 30, 15) and the G3a/G3b split: fact only citation; albumin-to-creatinine categories (A1 below 30, A2 30-299, A3 300 mg/g or above): fact only citation; 2021 creatinine equation: public domain. Source checked: opened. No endorsement by the cited bodies is implied.

To confirm with a clinician: three months is encoded as 90 days (the VA/DoD summary says 3 months or more).

CKD 3b

None entered

Supported and specific

The note says “CKD 3b” and two results 100 days apart agree (G3b range, filtering rate 40.6 on 2026-04-25 and 39.3 on 2026-08-03).

Clinician's response to the side-panel card: No response yet · offer OF-000012

Whole code category, for reference (no code is selected, ranked or suggested): Kidney disease stage (filtering rate) Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

N18 Chronic kidney disease (CKD) (9 codes in the category).

  • N18.1 Chronic kidney disease, stage 1
  • N18.2 Chronic kidney disease, stage 2 (mild)
  • N18.30 Chronic kidney disease, stage 3 unspecified
  • N18.31 Chronic kidney disease, stage 3a
  • N18.32 Chronic kidney disease, stage 3b
  • N18.4 Chronic kidney disease, stage 4 (severe)
  • N18.5 Chronic kidney disease, stage 5
  • N18.6 End stage renal disease
  • N18.9 Chronic kidney disease, unspecified

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

Hypoglycaemia (in people with diabetes)
measured

ada2026_hypoglycaemia@1.0 Draft · pending review

Level 1: glucose <70 mg/dL (<3.9 mmol/L) and ≥54 mg/dL (≥3.0 mmol/L)

  • glucose plasma 62 mg/dL 2026-11-12 06:00 · LM-P16-04

Window: 14 days before the check.

Citation

Hypoglycaemia level (ADA Standards of Care 2026)

ada2026_hypoglycaemia@1.0

In our words: Low glucose: below 70 mg/dL is level 1; below 54 mg/dL is level 2 (ADA's number, restated); level 3 is a severe event in which the person needs help, whatever the glucose.

a blood glucose reading lower than 70 milligrams per deciliter (mg/dL)

National Institute of Diabetes and Digestive and Kidney Diseases (NIDDK), Low Blood Glucose (Hypoglycemia) (2021) · Section 'What is low blood glucose?' · source

Licence: U.S. government work (public domain); level 2 (below 54 mg/dL, 3.0 mmol/L), the mmol/L values and level 3: fact only citation. Source checked: opened. No endorsement by the cited bodies is implied.

Contested: The International Hypoglycaemia Study Group (2017) sets level 1 at an alert value of 70 mg/dL (3.9 mmol/L) or lower, so exactly 70 counts, i.e. it includes exactly 70 mg/dL; ADA 2026 uses '<70'. CTCAE uses other cut-offs.

Not encoded: Level 3 is clinical: it is reported only when the caller supplies severe_event_requiring_assistance = true; otherwise it is skipped with a note. Whether the glucose came from a meter, CGM or laboratory is not distinguished; CGM duration criteria (for example 15 minutes) are not stated in the opened table and are not encoded.

Not stated

E16.2 Hypoglycemia, unspecified (visit diagnosis list (synthetic))

Supported, but entered or stated less specifically than the record supports

entered E16.2 (Hypoglycemia, unspecified)

The code family distinguishes: hypoglycaemia level 1, level 2, level 3 (E16.A1-E16.A3, new; not yet in the 2027 initial HCC file), drug-induced without coma, other, unspecified; in diabetes the combination codes E08-E13 with .64- are used.

Draft a query

Whole code category, for reference (no code is selected, ranked or suggested): Hypoglycaemia (in people with diabetes) Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

E16 Other disorders of pancreatic internal secretion: distinguishes hypoglycaemia level 1, level 2, level 3 (E16.A1-E16.A3, new; not yet in the 2027 initial HCC file), drug-induced without coma, other, unspecified; in diabetes the combination codes E08-E13 with .64- are used (10 codes in the category).

  • E16.0 Drug-induced hypoglycemia without coma
  • E16.1 Other hypoglycemia
  • E16.2 Hypoglycemia, unspecified
  • E16.3 Increased secretion of glucagon
  • E16.4 Increased secretion of gastrin
  • E16.8 Other specified disorders of pancreatic internal secretion
  • E16.9 Disorder of pancreatic internal secretion, unspecified
  • E16.A1 Hypoglycemia level 1
  • E16.A2 Hypoglycemia level 2
  • E16.A3 Hypoglycemia level 3

E11 Type 2 diabetes mellitus: distinguishes type 2 diabetes with hypoglycaemia with or without coma (E11.64-) (87 codes in the category).

87 codes; see the official files

Codes in this family for the category the record supports: E16.A1 Hypoglycemia level 1.

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

Diabetes mellitus
measured

ada2026_diabetes@1.0 Draft · pending review

Diabetes criteria met: two abnormal results (different tests, or the same test at two times)

  • hba1c 8.2 % 2026-09-12 09:00 · LM-P16-02

Window: 730 days before the check.

Citation

Diabetes diagnostic thresholds and the confirmation rule (ADA Standards of Care 2026)

ada2026_diabetes@1.0

In our words: Diabetes range: HbA1c 6.5% or higher, fasting glucose 126 mg/dL or higher, or 2-hour glucose 200 mg/dL or higher on a glucose tolerance test; two such results are needed (two different tests, or one test repeated). A random glucose of 200 mg/dL or higher counts on its own only with typical symptoms.

Usually, your doctor will use a second test to confirm you have diabetes.

National Institute of Diabetes and Digestive and Kidney Diseases (NIDDK), Diabetes Tests & Diagnosis (2022) · Section 'What test results tell me if I have diabetes or prediabetes?', table of test results · source

Licence: U.S. government work (public domain); confirmation counting: two results, from different tests or one test repeated: fact only citation. Source checked: opened. No endorsement by the cited bodies is implied.

Not encoded: Type of diabetes (type 1, type 2, other) is not assessed. Conditions that make A1C unreliable (some haemoglobin variants, pregnancy, G6PD deficiency, HIV, anaemia, haemodialysis, erythropoietin; recommendation 2.4 and text) are not checked: A1C results are used as sent. No maximum interval between the two abnormal results is stated by the source and none is applied. Whether the test method is NGSP-certified and whether a fasting sample was truly fasting are asserted by the sender through the analyte name. When two different tests are discordant ADA advises repeating the abnormal test; this entry simply reports one abnormal result.

diabetes

None entered

Supported and specific

Whole code category, for reference (no code is selected, ranked or suggested): Diabetes mellitus Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

E11 Type 2 diabetes mellitus: distinguishes type 2 diabetes with or without complications by body system (kidney, eye, nerve, circulatory, skin, oral, hypoglycaemia, hyperglycaemia, ketoacidosis, hyperosmolarity), long-term drug use is separate (Z79) (87 codes in the category).

87 codes; see the official files

E10 Type 1 diabetes mellitus: distinguishes type 1 diabetes with the same complication axes as E11 (87 codes in the category).

87 codes; see the official files

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

Prediabetes
measured

ada2026_prediabetes@1.0 Draft · pending review

Criteria not met: A result is in the diabetes range — prediabetes not assigned; see ada2026_diabetes

  • hba1c 8.2 % 2026-09-12 09:00 · LM-P16-02

Window: 365 days before the check.

Citation

Prediabetes ranges (ADA Standards of Care 2026)

ada2026_prediabetes@1.0

In our words: Intermediate range: HbA1c 5.7% to 6.4%, fasting glucose 100 to 125 mg/dL, or 2-hour glucose 140 to 199 mg/dL.

National Institute of Diabetes and Digestive and Kidney Diseases (NIDDK), Diabetes Tests & Diagnosis (2022) · Section 'What test results tell me if I have diabetes or prediabetes?', table of test results · source

Licence: U.S. government work (public domain). Source checked: opened. No endorsement by the cited bodies is implied.

Contested: Other bodies (for example WHO) are understood to use a different impaired fasting glucose range and not to use an A1C prediabetes range; those texts were not opened, so no other thresholds are recorded. Review item.

Not encoded: ADA does not require confirmation for prediabetes in Table 2.2; none is applied. A1C reliability conditions are not checked (see ada2026_diabetes). Only the most recent result of each test is used.

Not stated

None entered

Nothing to act on

Whole code category, for reference (no code is selected, ranked or suggested): Prediabetes Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

R73 Elevated blood glucose level: distinguishes R73.01 impaired fasting glucose, R73.02 impaired glucose tolerance (oral), R73.03 prediabetes, R73.09 other abnormal glucose, R73.9 hyperglycaemia unspecified (5 codes in the category).

  • R73.01 Impaired fasting glucose
  • R73.02 Impaired glucose tolerance (oral)
  • R73.03 Prediabetes
  • R73.09 Other abnormal glucose
  • R73.9 Hyperglycemia, unspecified

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

Extended capabilities (licence required before commercial use) 1

Extended capabilities: published criteria cited by title and restated in our own words, no text reproduced; a licence or permission is needed before commercial use. Shown to coders always; on clinician screens only when the setting is on (now off).

Extended capabilities (licence required before commercial use): condition families for this encounter (1)
Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
Hyperkalaemia
measured

ukka2026_hyperkalaemia@1.0 Draft · pending review

Criteria not met: Below 5.5 mmol/L

  • potassium serum 5.3 mmol/L 2026-11-12 07:00 · LM-P16-05

Window: 14 days before the check.

Citation

Hyperkalaemia and its severity (UK Kidney Association, July 2026 update)

ukka2026_hyperkalaemia@1.0

In our words: Serum potassium (adults): 5.5 to 5.9 mmol/L mild; 6.0 to 6.4 moderate; 6.5 or higher severe.

UK Kidney Association, Clinical Practice Guidelines: Treatment of Acute Hyperkalaemia in Adults (2026) · Introduction, document page 9 (PDF page 10) · source

Licence: cited source; wording is ours (numbers restated, no text reproduced). Source checked: opened. No endorsement by the cited bodies is implied.

Contested: The guideline itself says that no definition of hyperkalaemia is universally accepted; it adopts the ERC threshold of 5.5 mmol/L. CTCAE grades differ (see ctcae6_hyperkalaemia).

Not encoded: Pseudohyperkalaemia (guideline 15.3: haemolysis, delayed analysis, sampling technique) is not detected; a haemolysed sample is graded like any other unless the sender withholds it. Acute versus chronic (persistent) hyperkalaemia and the guideline's repeat-testing intervals (guidelines 1.2.1-1.2.3) are not encoded. ECG changes and clinical context are not assessed.

Not stated

None entered

Nothing to act on

Whole code category, for reference (no code is selected, ranked or suggested): Hyperkalaemia Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

E87 Other disorders of fluid, electrolyte and acid-base balance: distinguishes E87.5 hyperkalemia (one code; no severity axis) (14 codes in the category).

  • E87.0 Hyperosmolality and hypernatremia
  • E87.1 Hypo-osmolality and hyponatremia
  • E87.20 Acidosis, unspecified
  • E87.21 Acute metabolic acidosis
  • E87.22 Chronic metabolic acidosis
  • E87.29 Other acidosis
  • E87.3 Alkalosis
  • E87.4 Mixed disorder of acid-base balance
  • E87.5 Hyperkalemia
  • E87.6 Hypokalemia
  • E87.70 Fluid overload, unspecified
  • E87.71 Transfusion associated circulatory overload
  • E87.79 Other fluid overload
  • E87.8 Other disorders of electrolyte and fluid balance, not elsewhere classified

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).