API Hub

Explore and Make use of Nationally Defined Messaging APIs

This is a HL7 FHIR server, and as you appear to be accessing this page from a web browser you are seeing a HTML version of the requested resource(s). You can also access this URL from a FHIR client as a ReSTful API call. For more details please see the HL7 FHIR specification.
<CodeSystem xmlns="http://hl7.org/fhir">
   <id value="eRS-ReferralState-1"></id>
   <text>
      <status value="generated"></status>
   </text>
   <url value="https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1"></url>
   <version value="1.0.1"></version>
   <name value="eRS Referral State"></name>
   <status value="active"></status>
   <date value="2025-11-24"></date>
   <publisher value="NHS Digital"></publisher>
   <contact>
      <name value="Interoperability Team"></name>
      <telecom>
         <system value="email"></system>
         <value value="interoperabilityteam@nhs.net"></value>
         <use value="work"></use>
      </telecom>
   </contact>
   <description value="A CodeSystem to identify the Referral State of an appointment or referral."></description>
   <copyright value="Copyright © 2022 NHS Digital"></copyright>
   <caseSensitive value="true"></caseSensitive>
   <content value="complete"></content>
   <concept>
      <code value="APPT_CANCELLED_BY_PATIENT"></code>
      <display value="The referrals most recent appointment was cancelled at the request of, or directly by, a patient"></display>
   </concept>
   <concept>
      <code value="APPT_CANCELLED_BY_PROVIDER"></code>
      <display value="The referrals most recent appointment was cancelled by the service provider"></display>
   </concept>
   <concept>
      <code value="ASSESSMENT_RESULT"></code>
      <display value="A service provider has reviewed and drafted, or submitted a clinical assessment for the referral"></display>
   </concept>
   <concept>
      <code value="AWAITING_TRIAGE"></code>
      <display value="The triage referral is currently pending review with a service provider"></display>
   </concept>
   <concept>
      <code value="BOOKED"></code>
      <display value="The referral has a current state of booked"></display>
   </concept>
   <concept>
      <code value="CANCELLED_REFERRAL"></code>
      <display value="The referral has been cancelled and cannot be progressed any further"></display>
   </concept>
   <concept>
      <code value="DEFERRED_TO_PROVIDER"></code>
      <display value="The service provider will arrange the patient’s appointment"></display>
   </concept>
   <concept>
      <code value="DID_NOT_ATTEND"></code>
      <display value="The patient did not attend their last appointment"></display>
   </concept>
   <concept>
      <code value="NOT_BOOKED"></code>
      <display value="The referral is currently not booked, there is currently no planned patient encounter"></display>
   </concept>
   <concept>
      <code value="REJECTED"></code>
      <display value="The referral was rejected by a provider at their service"></display>
   </concept>
   <concept>
      <code value="TRIAGE_RESPONSE"></code>
      <display value="A service has passed the referral back to the referrer, with advice"></display>
   </concept>
   <concept>
      <code value="TRIAGED_PROVIDER_TO_ACTION"></code>
      <display value="The service provider has recorded a review decision, with the intention of processing this referral"></display>
   </concept>
</CodeSystem>