---
title: "Get referral status"
method: GET
path: "/referral/{referralID}/status"
---

# Get referral status

`GET /referral/{referralID}/status`

Returns the status of the referral with the given ID
A status update can be initiated by a clinician or admin, or set to be initiated automatically for all referrals as desired.

  **Step 1**: PMS system requests a status check to a specific referral ID using the same API key as for the referral

  **Step 2**: EeRS supplier provides response 200 with the status - or an error message

## Headers

- `Accept-Version` string
- `api-key` string

## Response `200`

OK

- StatusResponseYaml — unresolved $ref

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Referral with given ID not found
- `500` — Internal Server Error

## Changes

- **2022-02-16** `943937150819` — 4 breaking, 12 warning
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `404`
  - …12 more
- **2022-02-04** `3eca8930ae6c` — 18 warning, 2 info
  - removed the optional property `referralID` from the response with the `400` status
  - removed the optional property `referralID` from the response with the `401` status
  - removed the optional property `referralID` from the response with the `404` status
  - removed the optional property `referralURL` from the response with the `400` status
  - …16 more
- **2022-01-14** `188061fa84d8` — 1 warning
  - added the new `printed` enum value to the `referralStatus` response property for the response status `200`
- **2022-01-12** `4d66bed492b9` — 1 warning
  - the optional response header `Accept-Version` removed for the status `500`
- **2022-01-11** `585b6106a0a5` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - added the new optional `header` request parameter `api-key`

[Full history](https://skmtc.dev/nhs/apis/eyecare-electronic-referral-api/changes/referral/:referralID/status/get.md)

---

[API](https://skmtc.dev/nhs/apis/eyecare-electronic-referral-api.md) · [All operations](https://skmtc.dev/nhs/apis/eyecare-electronic-referral-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nhs/apis/eyecare-electronic-referral-api/revisions/73db55c79917?raw)