C-CDA Support

Data Structure

C-CDA Support

What is a C-CDA file?

Consolidated Clinical Document Architecture (C-CDA) is an HL7 standard that defines a structured, XML-based format for exchanging clinical documents. A C-CDA document is composed of human-readable narrative and machine-readable, coded data organized into sections and entries.

Common information contained in C-CDA documents includes:

  • Patient demographics and identifiers
  • Problems/diagnoses and past medical history
  • Allergies and adverse reactions
  • Medications and immunizations
  • Procedures, surgeries, and devices
  • Results (labs, imaging summaries) and vitals
  • Encounters and providers
  • Care plans, goals, and instructions

Document types supported

The platform supports the following clinical C-CDA document types:

  • Consultation Note
  • Continuity of Care Document (CCD)
  • Discharge Summary
  • History and Physical (H&P)
  • Operative Note
  • Procedure Note
  • Progress Note
  • Referral Note
  • Transfer Summary

Requirements and validation

  • Only clinical C-CDA documents are accepted. The file must be valid XML and conform to recognized C-CDA templates for one of the supported types listed above.
  • Non-clinical CDA variants, unsupported C-CDA document types, or malformed XML will be rejected during ingestion.

Error behavior

If the uploaded file is not a supported clinical C-CDA or the XML is invalid, the platform will return an error such as:

In some cases, additional context may be provided (for example, “Unsupported C-CDA document type”). Ensure your file is a valid clinical C-CDA for one of the supported types.