Retrieve healthcare service (A033, FHIR R4)

Overview

A patient may have 0 to 20 services associated with a single referral. A service is a place where a referrer can send a patient or obtain clinical advice concerning a specific patient. Services have attributes that can be used to understand a services functionality, terms of use, and contact information. You can use this endpoint to obtain the current version and attributes of a single service.

Supported security patterns

• Application-restricted, unattended access
• Healthcare worker, user-restricted access

Pre-requisites

Application-restricted access

In order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.

Healthcare worker, user-restricted access

In order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:

• REFERRING_CLINICIAN
• REFERRING_CLINICIAN_ADMIN

You need to have identified one service ID in order to use this endpoint.

Use case

As an authenticated user

I would like to be able to see current service information

So that I can trust that the service information is correct for my patient's referral

Related endpoints

• You can retrieve service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist containing at least a single service.
• You can check if a cached service has changed via [[HYPERLINK_A037]].
• You can retrieve the attributes of an entire shortlist of services (1-20) via [[HYPERLINK_A035]].

Known Issues

The HealthcareService.type attribute is being returned as a singular object by this endpoint. As per the FHIR standard, this attribute should be an array. See our problems and fixes section for more information.

Sandbox test scenarios

You can test the following scenarios in our sandbox environment