FHIR © HL7.org  |  Server Home  |  XIG Home  |  XIG Stats  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/patient-export

Packagehl7.fhir.us.bulkdata
Resource TypeOperationDefinition
Idpatient-export
FHIR VersionR4
Sourcehttp://hl7.org/fhir/us/bulkdata/http://hl7.org/fhir/us/bulkdata/2019May/OperationDefinition-patient-export.html
URLhttp://hl7.org/fhir/us/bulkdata/OperationDefinition/patient-export
Version1.0.0
Statusactive
Date2019-02-15T00:00:00+11:00
NamePatientLevelExport
TitleFHIR Bulk Data Export (Flat FHIR) - System Level Export
Realmus
Authorityhl7
DescriptionExport data from a FHIR server for all data associated with patients. This supports use cases like transmitting all data about patients or clinical care between systems
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

PatientLevelExport

OPERATION: PatientLevelExport

The official URL for this operation definition is:

http://hl7.org/fhir/us/bulkdata/OperationDefinition/patient-export

Export data from a FHIR server for all data associated with patients. This supports use cases like transmitting all data about patients or clinical care between systems

URL: [base]/Patient/$export

Parameters

UseNameCardinalityTypeBindingDocumentation
OUT_outputFormat0..1string

The format for the requested bulk data files to be generated. Servers MUST support Newline Delimited JSON, but MAY choose to support additional output formats. Servers MUST accept the full content type of application/fhir+ndjson as well as the abbreviated representations application/ndjson and ndjson. Defaults to application/fhir+ndjson

IN_since0..1instant

Resources updated after this period will be included in the response

OUT_type0..1string

A string of comma-delimited FHIR resource types. Only resources of the specified resource types(s) SHOULD be included in the response. If this parameter is omitted, the server SHOULD return all supported resources within the scope of the client authorization. For non-system-level requests, the Patient Compartment SHOULD be used as a point of reference for recommended resources to be returned as well as other resources outside of the patient compartment that are helpful in interpreting the patient data such as Organization and Practitioner. Resource references MAY be relative URIs with the format <resource type>/<id>, or absolute URIs with the same structure rooted in the base URI for the server from which the export was performed. References will be resolved looking for a resource with the specified type and id within the file set. Note: Implementations MAY limit the resources returned to specific subsets of FHIR, such as those defined in the Argonaut Implementation Guide


Source

{
  "resourceType": "OperationDefinition",
  "id": "patient-export",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "http://hl7.org/fhir/us/bulkdata/OperationDefinition/patient-export",
  "version": "1.0.0",
  "name": "PatientLevelExport",
  "title": "FHIR Bulk Data Export (Flat FHIR) - System Level Export",
  "status": "active",
  "kind": "operation",
  "date": "2019-02-15T00:00:00+11:00",
  "publisher": "SMART Health IT",
  "contact": [
    {
      "name": "Ricky Sahu",
      "telecom": [
        {
          "system": "email",
          "value": "ricky@1up.health"
        }
      ]
    },
    {
      "name": "Dan Gottlieb",
      "telecom": [
        {
          "system": "email",
          "value": "daniel.gottlieb@childrens.harvard.edu"
        }
      ]
    },
    {
      "name": "Josh Mandel",
      "telecom": [
        {
          "system": "email",
          "value": "joshua.mandel@childrens.harvard.edu"
        }
      ]
    },
    {
      "name": "Vlad Ignatov",
      "telecom": [
        {
          "system": "email",
          "value": "Vladimir.Ignatov@childrens.harvard.edu"
        }
      ]
    }
  ],
  "description": "Export data from a FHIR server for all data associated with patients. This supports use cases like transmitting all data about patients or clinical care between systems",
  "code": "$export",
  "resource": [
    "Patient"
  ],
  "system": false,
  "type": true,
  "instance": false,
  "parameter": [
    {
      "name": "_outputFormat",
      "use": "out",
      "min": 0,
      "max": "1",
      "documentation": "The format for the requested bulk data files to be generated. Servers MUST support Newline Delimited JSON, but MAY choose to support additional output formats. Servers MUST accept the full content type of application/fhir+ndjson as well as the abbreviated representations application/ndjson and ndjson. Defaults to application/fhir+ndjson",
      "type": "string"
    },
    {
      "name": "_since",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Resources updated after this period will be included in the response",
      "type": "instant"
    },
    {
      "name": "_type",
      "use": "out",
      "min": 0,
      "max": "1",
      "documentation": "A string of comma-delimited FHIR resource types. Only resources of the specified resource types(s) SHOULD be included in the response. If this parameter is omitted, the server SHOULD return all supported resources within the scope of the client authorization. For non-system-level requests, the Patient Compartment SHOULD be used as a point of reference for recommended resources to be returned as well as other resources outside of the patient compartment that are helpful in interpreting the patient data such as Organization and Practitioner. Resource references MAY be relative URIs with the format <resource type>/<id>, or absolute URIs with the same structure rooted in the base URI for the server from which the export was performed. References will be resolved looking for a resource with the specified type and id within the file set. Note: Implementations MAY limit the resources returned to specific subsets of FHIR, such as those defined in the Argonaut Implementation Guide",
      "type": "string"
    }
  ]
}