{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/heidi-health/main/json-schema/heidi-health-clinical-code-schema.json",
  "title": "HeidiClinicalCode",
  "description": "Clinical code generated by Heidi for a session — supports ICD-10, ICD-10-CM, ICD-9, ICD-9-CM, SNOMED, SNOMED-CT, OPCS-410, ACHI-13, CPT-2025.",
  "type": "object",
  "required": ["code", "coding_system"],
  "properties": {
    "code": { "type": "string" },
    "description": { "type": "string" },
    "coding_system": {
      "type": "string",
      "enum": ["ICD-10", "ICD-10-CM", "ICD-9", "ICD-9-CM", "SNOMED", "SNOMED-CT", "OPCS-410", "ACHI-13", "CPT-2025"]
    },
    "effective_date": { "type": "string", "format": "date" },
    "valid": { "type": "boolean" },
    "hierarchy": { "type": "array", "items": { "type": "string" } },
    "references": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": { "type": "string", "enum": ["TRANSCRIPT", "CONSULT_NOTE"] },
          "text": { "type": "string" },
          "start": { "type": "integer" },
          "end": { "type": "integer" }
        }
      }
    }
  },
  "additionalProperties": true
}