The Veradigm FHIR API is used to work with clinical data for a single patient or small group of patients. However, it is not technically feasible to use the usual Veradigm FHIR API requests to pass bulk data because of the number of requests and system resources involved. To support these cases, bulk data requests are available.
There are a variety of reasons why external systems would request bulk data from an Veradigm product. A few examples include:
Note: For more information from HL7 on the FHIR specification for bulk data exports, see Export : /export/ (hl7.org).
Unlike other Veradigm FHIR API requests, requesting bulk data is an asynchronous process; the Veradigm product does not immediately return information. The application makes the initial request and then waits for the Veradigm product to prepare the data.
The process of requesting and receiving bulk data flows as follows:
When the developer creates their FHIR application in the Veradigm Developer Portal, the following must be true in order for the application to request bulk data:
The Veradigm FHIR Bulk Data API can extract bulk data from the following FHIR resources:
The bulk data request supports the Provenance resource. The response file includes provenance data under the following conditions:
[FHIR path]/Group/ABC/$export
Provenance is included when explicitly listed in the request for a specific resource.
If provenance is passed as a requested resource, all other resources that are included in the request should then include provenance.
If provenance is not passed as a requested resource, no resources that are included in the request should include provenance.
For more information on the Provenance resource, see the Searching topic.
The application makes the initial bulk data request using $export. For example:
[FHIR path]/Group/INF-101/$export
Means: “Get all the patients in the Group resource with the ID INF-101.”
Note: The requesting application must be authorized to access the data requested.
The application requests a status of the export package progress.
GET [Content Location URL]
In the body of the response, a series of URLs are listed for individual packages for download depending on the size of the request. These URLs are included in the file request.
The application can delete an export request if it was created in error or is no longer needed.
DELETE [Content Location URL]
After the application receives a status update that indication the requested export files are complete, the application retrieves the files.
GET [Content Location URL from the body of the completed request response]