FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon . Page versions: R5 R4B R4 R3

Using Codes Code Systems Value Sets Concept Maps Identifier Systems

4.2.12.478 4.3.2.184 Code System CodeSystem http://hl7.org/fhir/appointmentstatus

  Maturity Level : 3
Vocabulary Responsible Owner: Patient Administration icon Work Group Informative Normative Use Context : Any Country: World
This is a code system defined by the FHIR project. Summary
  • Defining URL: Narrative http://hl7.org/fhir/appointmentstatus
  • XML Name:
  • AppointmentStatus JSON
  • Definition: TTL The free/busy status of an appointment.
OID:
Official URL : Committee: http://hl7.org/fhir/appointmentstatus Work Group Version : 6.0.0-ballot3
active as of 2021-01-04 2.16.840.1.113883.4.642.1.478 (for OID based terminology systems) Computable Name : AppointmentStatus Source Resource
XML / JSON Flags : CaseSensitive, Complete. All codes ValueSet: Appointment Status OID : 2.16.840.1.113883.4.642.4.485

This Code system is used in the following FHIR core-defined or referenced value sets:

4.2.12.478.1 4.3.2.184.1 Content Definition

The free/busy status of an appointment.

4.2.12.478.2 4.3.2.184.2 AppointmentStatus Content

The free/busy status of an appointment.

Generated Narrative: CodeSystem appointmentstatus

Last updated: 2025-12-17T09:50:17.012Z

This case-sensitive code system http://hl7.org/fhir/appointmentstatus defines the following codes:

Code Display Definition Copy
proposed Proposed

None of the participant(s) have finalized their acceptance of the appointment request, and the start/end time may might not be set yet.

btn   btn
pending Pending

Some or all of the participant(s) have not finalized their acceptance of the appointment request.

btn   btn
booked Booked

All participant(s) have been considered and the appointment is confirmed to go ahead at the date/times specified.

btn   btn
arrived Arrived

The patient/patients has/have arrived and is/are waiting to be seen.

Some of the patients have arrived. btn   btn
fulfilled Fulfilled This

The planning stages of the appointment has completed are now complete, the encounter resource will exist and may have resulted in will track further status changes. Note that an encounter. encounter may exist before the appointment status is fulfilled for many reasons.

btn   btn
cancelled Cancelled

The appointment has been cancelled.

btn   btn
noshow No Show

Some or all of the participant(s) have not/did not appear for the appointment (usually the patient).

btn   btn
entered-in-error Entered in error

This instance should not have been part of this patient's medical record.

btn   btn
checked-in Checked In

When checked in, all pre-encounter administrative work is complete, and the encounter may begin. (where multiple patients are involved, they are all present).

btn   btn
waitlist Waitlisted

The appointment has been placed on a waitlist, to be scheduled/confirmed in the future when a slot/service is available. A specific time might or might not be pre-allocated.

btn   btn

 

See the full registry of value sets code systems defined as part of FHIR.

Explanation of the columns that may appear on this page:

Level A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies See Code System for further information.
Source The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code The code (used as the code in the resource instance). If the code is in italics, this indicates that the code is not selectable ('Abstract')
Display The display (used in the display element of a Coding ). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition An explanation of the meaning of the concept
Comments Additional notes about how to use the code