Bulk Data Access IG
1.1.0 - STU 2 Ballot

This page is part of the FHIR Bulk Data Access (Flat FHIR) (v1.1.0: STU 2 (FHIR R4) Ballot 1) based on FHIR R4. The current version which supercedes this version is 1.0.1. For a full list of available versions, see the Directory of published versions

OperationDefinition: FHIR Bulk Data System Level Export

BulkDataExport

OPERATION: BulkDataExport

The official URL for this operation definition is: 

http://hl7.org/fhir/uv/bulkdata/OperationDefinition/export

Export data from a FHIR server whether or not it is associated with a patient. This supports use cases like backing up a server or exporting terminology data by restricting the resources returned using the _type parameter. The FHIR server SHALL support invocation of this operation using the FHIR Asynchronous Request Pattern

URL: [base]/$export

Parameters

UseNameCardinalityTypeBindingDocumentation
IN_outputFormat0..1string

The format for the requested bulk data files to be generated. Defaults to application/fhir+ndjson.

IN_since0..1instant

Resources will be included in the response if their state has changed after the supplied time (e.g. if Resource.meta.lastUpdated is later than the supplied _since time).

IN_type0..1string

A string of comma-delimited FHIR resource types. The response SHALL be filtered to only include resources of the specified resource types(s).

IN_elements0..1string

Experimental. String of comma-delimited FHIR Elements. The server SHOULD omit unlisted, non-mandatory elements from the resources returned. Elements should be of the form [resource type].[element name] (eg. Patient.id) or [element name] (eg. id) and only root elements in a resource are permitted. If the resource type is omitted, the element should be returned for all resources in the response where it is applicable.

Servers are not obliged to return just the requested elements. Servers SHOULD always return mandatory elements whether they are requested or not. Servers SHOULD mark the resources with the tag SUBSETTED to ensure that the incomplete resource is not actually used to overwrite a complete resource.

INincludeAssociatedData0..1codehttp://hl7.org/fhir/uv/bulkdata/ValueSet/include-associated-data (Extensible)

Experimental. Servers with support for the requested values SHALL return or omit a pre-defined set of FHIR resources associated with the request.

IN_typeFilter0..1string

Experimental. String of comma separated FHIR REST search queries. Servers with support for the requested search queries SHALL filter the data in the response to only include resources that meet the specified criteria.