Solventum · Schema

CodingResult

The output of Solventum's computer-assisted coding (CAC) engine, including suggested ICD-10 codes, DRG assignment, and quality flags.

DentalEHRElectronic Health RecordsHealthcareHealthcare ITHealth Information SystemsMedical DevicesMedical Technology

Properties

Name	Type	Description
encounterId	string	Reference to the source encounter
processingTimestamp	string	When coding was performed
codeSetVersion	string	ICD-10 code set version used (e.g., FY2026)
suggestedDiagnoses	array	AI-suggested diagnosis codes with confidence scores
suggestedProcedures	array	AI-suggested procedure codes with confidence scores
drgAssignment	object	Diagnosis-Related Group assignment result
qualityFlags	array	Documentation quality and compliance alerts

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/solventum/main/json-schema/solventum-coding-result-schema.json",
  "title": "CodingResult",
  "description": "The output of Solventum's computer-assisted coding (CAC) engine, including suggested ICD-10 codes, DRG assignment, and quality flags.",
  "type": "object",
  "properties": {
    "encounterId": {
      "type": "string",
      "description": "Reference to the source encounter"
    },
    "processingTimestamp": {
      "type": "string",
      "format": "date-time",
      "description": "When coding was performed"
    },
    "codeSetVersion": {
      "type": "string",
      "description": "ICD-10 code set version used (e.g., FY2026)"
    },
    "suggestedDiagnoses": {
      "type": "array",
      "description": "AI-suggested diagnosis codes with confidence scores",
      "items": {
        "type": "object",
        "properties": {
          "code": { "type": "string", "description": "ICD-10-CM code" },
          "description": { "type": "string", "description": "Code description" },
          "type": { "type": "string", "enum": ["principal", "secondary", "admitting", "external-cause"] },
          "confidence": { "type": "number", "minimum": 0, "maximum": 1, "description": "AI confidence score" },
          "evidenceText": { "type": "string", "description": "Supporting text from clinical notes" },
          "status": { "type": "string", "enum": ["suggested", "accepted", "rejected", "modified"], "description": "Coder review status" }
        }
      }
    },
    "suggestedProcedures": {
      "type": "array",
      "description": "AI-suggested procedure codes with confidence scores",
      "items": {
        "type": "object",
        "properties": {
          "code": { "type": "string", "description": "ICD-10-PCS or CPT code" },
          "description": { "type": "string" },
          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
          "evidenceText": { "type": "string" },
          "status": { "type": "string", "enum": ["suggested", "accepted", "rejected", "modified"] }
        }
      }
    },
    "drgAssignment": {
      "type": "object",
      "description": "Diagnosis-Related Group assignment result",
      "properties": {
        "msdrg": { "type": "string", "description": "Medicare Severity DRG code" },
        "msdrgDescription": { "type": "string", "description": "MS-DRG description" },
        "mdc": { "type": "string", "description": "Major Diagnostic Category" },
        "severity": { "type": "string", "enum": ["1", "2", "3", "4"], "description": "Severity of illness (1=minor, 4=extreme)" },
        "mortalityRisk": { "type": "string", "enum": ["1", "2", "3", "4"], "description": "Risk of mortality score" },
        "geometricMeanLos": { "type": "number", "description": "Expected geometric mean length of stay" },
        "relativeWeight": { "type": "number", "description": "MS-DRG relative weight for reimbursement" }
      }
    },
    "qualityFlags": {
      "type": "array",
      "description": "Documentation quality and compliance alerts",
      "items": {
        "type": "object",
        "properties": {
          "flagType": { "type": "string", "description": "Type of quality flag" },
          "severity": { "type": "string", "enum": ["info", "warning", "error"] },
          "message": { "type": "string", "description": "Flag description" }
        }
      }
    }
  },
  "required": ["encounterId", "processingTimestamp"]
}