---
title: "Retrieve healthcare service"
method: GET
path: "/FHIR/R4/HealthcareService/{id}"
---

# Retrieve healthcare service

`GET /FHIR/R4/HealthcareService/{id}`

## Request

- Base URL: `https://int.api.service.nhs.uk/e-referrals-service-patient-care-api`
- URL: `https://int.api.service.nhs.uk/e-referrals-service-patient-care-api/FHIR/R4/HealthcareService/{id}`
- Auth: HTTP bearer

## Overview

Use this endpoint to retrieve attributes about a single service.

## Pre-requisites

In order to use this endpoint the patient must be an authenticated user.

The patient needs to have authenticated via [[HYPERLINK_NHS_LOGIN]] and meet the required [identity proofing level](https://nhsconnect.github.io/nhslogin/vectors-of-trust/) (currently this is "P9").

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

## Use case

As an authenticated user

I want to know more about a healthcare service  

So that I can make appropriate decisions about my care

## Related endpoints

If a referral currently has an appointment booking to a service or is deferred to a service then [[HYPERLINK_A001]] can be used to retrieve the Service ID of that service.

## Path parameters

- `id` string, required

## Parameters

- `#/paths/~1FHIR~1R4~1ServiceRequest/get/parameters/3` (unresolved $ref)

## Response `200`

The Response contains a Healthcare service.

- object
  - `id` string, required
  - `meta` object, required
    - `versionId` string, required
    - `profile` string[], required
  - `identifier` object[], required
    - `system` 'https://fhir.nhs.uk/Id/ers-service', required
    - `value` string, required
  - `resourceType` 'HealthcareService', required
  - `providedBy` object, required
    - `identifier` object, required
      - `system` 'https://fhir.nhs.uk/Id/ods-organization-code', required
      - `value` string, required
  - `specialty` object[], required
    - `coding` array[], required
      - object[]
        - `system` 'https://fhir.nhs.uk/CodeSystem/eRS-Specialty', required
        - `code` string, required
        - `display` string, required
  - `type` object[]
    - `coding` object[], required
      - `system` 'https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType', required
      - `code` 'TELEPHONE_ASSESSMENT' | 'OPHTHALMOLOGIST' | 'NURSE_CLINIC' | 'GPSI' | 'FIRST_OUTPATIENT' | 'DIAGNOSTIC' | 'DAY_CASE' | 'ASSESSMENT_SERVICE' | 'AHP_CLINIC', required
  - `location` object[], required
    - `identifier` object: Reference detailing the location a service is based within.
      - `system` 'https://fhir.nhs.uk/Id/ods-site-code'
      - `value` string
  - `name` string, required: Name of the HealthcareService (as per e-RS Directory of Services).
  - `endpoint` union[]: Slot Management Provider System Endpoint, only applicable if the HealtchareService is directly bookable.
    - union
      - object
        - `identifier` object, required
          - `system` 'https://fhir.nhs.uk/Id/nhsSpineASID', required
          - `value` string, required
      - object
        - `identifier` object, required
          - `system` 'https://fhir.nhs.uk/Id/nhsMhsPartyKey', required
          - `value` string, required

## Other responses

- `401` (unresolved $ref)
- `404`: Where status code 404 (Resource Not Found) is returned then an OperationOutcome will be included in the body, as detailed below. | Error code | Description | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | REC_NOT_FOUND | The healthcare service with the specified ID does not exist |
- `429` (unresolved $ref)
- `500` (unresolved $ref)
- `504` (unresolved $ref)

---

[API](https://skmtc.dev/nhs/apis/e-referrals-service-patient-care-api.md) - [All operations](https://skmtc.dev/nhs/apis/e-referrals-service-patient-care-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs/apis/e-referrals-service-patient-care-api/revisions/10aae95b47cd?raw)