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 R2

Using Codes Code Systems Value Sets Concept Maps Identifier Systems

4.3.1.477 4.4.1.150 Value Set ValueSet http://hl7.org/fhir/ValueSet/appointmentstatus

  Maturity Level : 3
Responsible Owner: Patient Administration icon Work Group Informative Normative Use Context : Any Country: World
This is a value set defined by the FHIR project. Summary
  • Defining URL: Narrative http://hl7.org/fhir/ValueSet/appointmentstatus
  • XML Name:
  • AppointmentStatus JSON
  • Definition: TTL The free/busy status of an appointment.
OID:
Official URL : Committee: http://hl7.org/fhir/ValueSet/appointmentstatus Work Group Version : 6.0.0-ballot3
active as of 2020-12-28 2.16.840.1.113883.4.642.3.477 (for OID based terminology systems) Computable Name : AppointmentStatus
Source Resource Flags : Immutable XML / JSON OID : 2.16.840.1.113883.4.642.3.484

This value set is used in the following places:

4.3.1.477.1 4.4.1.150.1 Definition

The free/busy status of an appointment.

4.4.1.150.2 Content Logical Definition

This value set includes codes from the following code systems:

Generated Narrative: ValueSet appointmentstatus

Last updated: 2025-11-20T23:56:49.898Z

 

4.3.1.477.2 4.4.1.150.3 Expansion

This expansion generated 19 Apr 2017 20 Nov 2025

ValueSet This value set contains 8 concepts

Expansion performed internally based on http://hl7.org/fhir/appointmentstatus version 3.0.2 All codes from system http://hl7.org/fhir/appointmentstatus codesystem Appointment Status v6.0.0-ballot3 (CodeSystem)

This value set contains 10 concepts

System Code Display Definition Canonical Mapping for "Appointment Status"
http://hl7.org/fhir/appointmentstatus    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.

~ proposed
http://hl7.org/fhir/appointmentstatus    pending Pending

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

~ draft
http://hl7.org/fhir/appointmentstatus    booked Booked

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

~ accepted
http://hl7.org/fhir/appointmentstatus    arrived Arrived

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

Some of the patients have arrived. ~ arrived
http://hl7.org/fhir/appointmentstatus    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.

~ complete
http://hl7.org/fhir/appointmentstatus    cancelled Cancelled

The appointment has been cancelled.

~ abandoned
http://hl7.org/fhir/appointmentstatus    noshow No Show

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

~ suspended
http://hl7.org/fhir/appointmentstatus    entered-in-error Entered in error

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

~ error
http://hl7.org/fhir/appointmentstatus    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).

~ partial
http://hl7.org/fhir/appointmentstatus    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.

~ proposed

 

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

Explanation of the columns that may appear on this page:

Level Lvl A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes For value sets, levels are under other codes, and imply that the mostly used to organize codes for user convenience, but may follow code they are under also applies system hierarchy - 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