Profiles & Operations > Operation: Retrieve Location

Retrieve Location

Location Read is a simple RESTful interactions. It aligns with the generic RESTful read operation defined in the FHIR core specification. It supports retrieving a single Location instance by their RESTful resource id.In this implementation, the resource id refers to provider Location EPID in PPR.

Scope

This transaction involves a request by a FHIR Provider RESTful Client for the identification, naming, licensing and contact information associated with a single Location record, identified by the target server's record id for that Location. The request is received by the FHIR Provider RESTful Server which returns the requested record.

For example, an immunization or medication record provides a FHIR "reference" pointing to the Provincial Provider Registry "id" for a particular Location. To look up information about the referenced Location, the EMR uses the read operation to retrieve the Location's contact and other information from the registry.

Interaction Diagrams

The following diagram illustrates the high level interaction between a FHIR Provider RESTful Client and FHIR Provider RESTful Server. The Provider transaction will use the following queries and responses:

• Read Location / Read Location Response

Actor: FHIR Provider RESTful Client

Role: Requests a demographic details for a single Location based on a known resource id from the FHIR Provider RESTful Server. The FHIR Provider RESTful Client populates its local store with information received from the FHIR Provider RESTful Server

Actor: FHIR Provider RESTful Server

Role: Returns demographic information for the single Location corresponding to the resource id specified by the FHIR Provider RESTful Client.

NOTE: In this implementation guide, Provincial Provider Registry is the FHIR Provider RESTful Server. All subsequent references of this actor should be interpreted as Provincial Provider Registry.

Specification

This FHIR spec is based on the HL7 R4 Read operation. It makes use of the following resources:

Provider Location Read Request

GET [base]/Location/EPID(Logical ID)

Provider Location Read Response

• ca-on-ppr-location-response-profile-Location

General

• ca-on-ppr-profile-OperationOutcome

The PPR FHIR profiles are developed to constrain value sets and cardinality of data elements in the resources listed above. Since FHIR R4 does not support all the data elements required for this project, we have introduced a few extensions which can be found here.

Extensions

The PPR FHIR profiles are developed to constrain value sets and cardinality of data elements in the resources listed above. Since FHIR R4 does not support all the data elements required for this project, we have introduced a few extensions which can be found here.

Extensions

• address-confidential (Address Confidential)

• address-purpose (Address Purpose)

• lhin-code (Local Health Integration Network Code)

• status-date (Status Date)

• status-reason (Status Reason)

• language (Language Code)

• organization-type (Organization Type)

• registration-subclass (Registration Subclass)

• organization-name-type (Organization Name Type)

Summary of Supported Operations

The table below shows the allowed transactions for each profile and how they support FHIR endpoints, resources and their corresponding HTTP operations:

The interaction summary table below lists the HTTP status codes that may be returned for the query.

Location Read Operations

This represents an HTTP GET specifying the id of a single Location instance from the FHIR Provider RESTful Client to retrieve the resource from the FHIR Provider RESTful Server.

Trigger Event

When a FHIR Provider RESTful Client has the server's "id" for an Location but does not yet have the name, contact, license and other information or wishes to retrieve an updated version of the Location's information, it invokes an Location read.

Expected Behaviour

The FHIR Provider RESTful Server shall return the records that correspond to the "id" provided by the FHIR Provider RESTful Client. The FHIR Provider RESTful Server shall respond synchronously (i.e. on the same connection as was used to initiate the request).

See Response Handling page for additional response handling behaviour.

Examples

Location read request :

Examples of Location Read request can be found below

GET [base]/Location/67890

Location search response):

Examples of a Location read response can be found below

• Example - Location Read Response, Location Resource - JSON

Example of Operation Outcome

• Example Operation Outcome - JSON