---
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

- object
  - `referralStatus` 'incomplete' | 'submitted' | 'closednotsubmitted' | 'printed' — Shows the current status of the referral which will be one of: * **incomplete** - the referral has been received in the EeRS system but has not yet not been closed or submitted. * **submitted** - the referral has been submitted to a provider for onward care. * **closednotsubmitted** - the referral has been closed by the user without being submitted for any further review or action by service providers e.g. because a clinician decided that a referral wasn't necessary. * **printed** - the referral was entered manually. Only populated for 200 SUCCESS response.
  - `errorMessage` string — For responses other than 200 SUCCESS an error message will be populated.
  - `errorCode` string — For responses other than 200 SUCCESS an error code will be populated.

## Other responses

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

---

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