Exporting C-CDAs
The $export-ccda operation allows you to generate and retrieve a Consolidated Clinical Document Architecture (CCDA) file for a patient. The file is built from normalized FHIR resources returned by $p360-retrieve and packaged in a structured XML format suitable for downstream systems or regulatory reporting.
Use Cases
- Generate a clinical document snapshot of a patient’s aggregated record
- Support regulatory or quality reporting workflows that require CCDA format
- Transfer structured records to systems that do not support FHIR
FHIR Version Support
The $export-ccda operation is supported in both R4 and STU3.
- In R4, the operation commonly follows a synchronous
$p360-retrieve, with asynchronous handling available for large datasets or longer processing times. - In STU3, the operation typically follows an asynchronous
$p360-retrievebecause some responses cannot be returned synchronously due to payload size or processing time.
Request Format
Submit a GET request after a successful $p360-retrieve operation:
GET /fhir/[version]/Patient/[id]/$export-ccda
The response includes a FHIR DocumentReference pointing to a CCDA file stored as a Binary resource. The file can be downloaded using the DocumentReference.content.attachment.url.
Behavior
- Available only after a completed
$p360-retrieve - Returns a single document representing the patient’s longitudinal record
- Content reflects deduplicated and normalized data at the time of export
- Format adheres to standard CCDA specifications, supporting sections such as Problems, Medications, Allergies, and Results
- Pagination does not apply to
$export-ccda. The entire document is returned as a singleBinaryresource attachment.