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 Group Level Export

GroupLevelExport

OPERATION: GroupLevelExport

The official URL for this operation definition is: 

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

FHIR Operation to obtain a detailed set of FHIR resources of diverse resource types pertaining to all patients in specified Group. The FHIR server SHALL support invocation of this operation using the FHIR Asynchronous Request Pattern

URL: [base]/Group/[id]/$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). Servers MAY return additional resources modified prior to the supplied time if the resources belong to the patient compartment of a patient added to the Group after the supplied time (this behavior should be clearly documented by the server).

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.

INpatient0..*Reference

The server SHALL NOT return resources in the patient compartments belonging to patients outside of this list.

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.