POST /convert/v1/cdatofhirr4/:patientID
This operation converts a CDA document into a FHIR R4 bundle.
Contents
The input for this operation is a single CDA document. Supported CDA formats/versions are:
The output is a FHIR R4 Bundle containing the clinical data parsed out of the CDA, along with an OperationOutcome resource detailing the results (including warnings or errors) of the conversion process.
The input for the CDA to FHIR conversion is XML, so be sure to specify content-type: application/xml
in your request header.
You can specify either accept: application/json
or accept: application/xml
in your request header to get a response in either JSON or XML format.
CDA documents and FHIR Bundles are verbose, so this just shows a small sample to illustrate how the data is structured. For a more complete example, try out the API in the Developer Portal Sandbox.
For example, a patient
node in the CDA XML:
<patient classCode="PSN" determinerCode="INSTANCE">
<name>
<given>John</given>
<family>Smith</family>
</name>
...
</patient>
would be converted to a Patient
resource in the FHIR bundle:
"resource": {
"resourceType": "Patient",
"id": "35b77437-425d-419c-90b5-af4bc433ebe9",
"name": [
{
"use": "official",
"family": "Smith",
"given": [
"John"
]
}
],
...
}
For details on the output fields, refer to the FHIR Specification.