This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
This is the narrative for the resource. See also the XML or JSON format.
OPERATION: Fetch Patient Record
This operation is used to return all the information related to patient described in the resource on which this operation is invoked. The response is a bundle of type "searchset". At a minimum, the patient resource itself is returned, along with any other resources that the server has available for the given user. The server also returns whatever resources are needed to support the records - e.g. linked practitioners, locations, organizations etc. The principle intended use for rhis operation is to provide a patient with access to their records (e.g. "Blue Button").
The server SHOULD return all resources that it has that are in the patient compartment for the identified patient, and any resource referenced from those, including binaries and attachments. At a mimimum, the resources returned SHALL include all the data covered by the meaningful use common data elements (ref to be provided). Other applicable implementation guides may make additional rules about the information that is returned. Note: the expectations here will be refined after experience with this at connectathon.
URL: [base]/Patient/$Fetch Patient Record
URL: [base]/Patient/[id]/$Fetch Patient Record
Parameters
Use | Name | Cardinality | Type | Documentation |
IN | start | 0..1 | date | The date range relates to care dates, not record currency dates - e.g all records relating to care provided in a certain date range. If no date is provided, all records are in scope. |
IN | end | 0..1 | date | The date range relates to care dates, not record currency dates - e.g all records relating to care provided in a certain date range. If no date is provided, all records are in scope. |
OUT | return | 1..1 | Bundle | The bundle type is "searchset" |
The key differences between this operation and simply searching the patient compartment are:
It is assumed that the server has identified and secured the context appropriately, and can either associate the authorization context with a single patient, or determine whether the context has the rights to the nominated patient, if there is one. If there is no nominated patient (e.g. the operation is invoked at the system level) and the context is not associated with a single patient record, then the server should return an error. Speciying the relationship between the context, a user and patient records is outside the scope of this specification.
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.