description: A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s).
package_name: hl7.fhir.r4b.examples
derivation: specialization
name: Appointment
type: Appointment
elements:
  description: {isModifier: false, short: 'Shown on a subject line in a meeting request, or appointment list', type: string, mustSupport: false, isSummary: false, index: 10}
  serviceCategory:
    isModifier: false
    short: A broad categorization of the service that is to be performed during this appointment
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/service-category'}
    isSummary: true
    index: 3
  slot:
    isModifier: false
    short: The slots that this appointment is filling
    refers: ['http://hl7.org/fhir/StructureDefinition/Slot']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 15
  specialty:
    isModifier: false
    short: The specialty of a practitioner that would be required to perform the service requested in this appointment
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/c80-practice-codes'}
    isSummary: true
    index: 5
  cancelationReason:
    isModifier: false
    short: The coded reason for the appointment being cancelled
    type: CodeableConcept
    mustSupport: false
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/appointment-cancellation-reason'}
    isSummary: true
    index: 2
  requestedPeriod: {isModifier: false, short: Potential date/time interval(s) requested to allocate the appointment within, type: Period, mustSupport: false, array: true, isSummary: false, index: 26}
  patientInstruction: {isModifier: false, short: Detailed information and instructions for the patient, type: string, mustSupport: false, isSummary: false, index: 18}
  start: {isModifier: false, short: When appointment is to take place, type: instant, mustSupport: false, isSummary: true, index: 12}
  reasonCode:
    isModifier: false
    short: Coded reason this appointment is scheduled
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/encounter-reason'}
    isSummary: true
    index: 7
  created: {isModifier: false, short: The date that this appointment was initially created, type: dateTime, mustSupport: false, isSummary: false, index: 16}
  participant:
    constraint:
      app-1: {human: Either the type or actor on the participant SHALL be specified, source: 'http://hl7.org/fhir/StructureDefinition/Appointment', severity: error, expression: type.exists() or actor.exists()}
    min: 1
    isModifier: false
    short: Participants involved in appointment
    index: 20
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      type:
        isModifier: false
        short: Role of participant in the appointment
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/encounter-participant-type'}
        isSummary: true
        index: 21
      actor:
        isModifier: false
        short: Person, Location/HealthcareService or Device
        refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/HealthcareService', 'http://hl7.org/fhir/StructureDefinition/Location', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        mustSupport: false
        isSummary: true
        index: 22
      required:
        isModifier: false
        short: required | optional | information-only
        type: code
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/participantrequired|4.3.0'}
        isSummary: true
        index: 23
      status:
        isModifier: false
        short: accepted | declined | tentative | needs-action
        type: code
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/participationstatus|4.3.0'}
        isSummary: true
        index: 24
      period: {isModifier: false, short: Participation period of the actor, type: Period, mustSupport: false, isSummary: false, index: 25}
    required: [status]
    isSummary: false
  serviceType:
    isModifier: false
    short: The specific service that is to be performed during this appointment
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/service-type'}
    isSummary: true
    index: 4
  supportingInformation:
    isModifier: false
    short: Additional information to support the appointment
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 11
  priority: {isModifier: false, short: Used to make informed decisions if needing to re-prioritize, type: unsignedInt, mustSupport: false, isSummary: false, index: 9}
  appointmentType:
    isModifier: false
    short: The style of appointment or patient that has been booked in the slot (not service type)
    type: CodeableConcept
    mustSupport: false
    binding: {strength: preferred, valueSet: 'http://terminology.hl7.org/ValueSet/v2-0276'}
    isSummary: true
    index: 6
  status:
    isModifier: true
    short: proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist
    index: 1
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/appointmentstatus|4.3.0'}
    isModifierReason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    isSummary: true
  comment: {isModifier: false, short: Additional comments, type: string, mustSupport: false, isSummary: false, index: 17}
  minutesDuration: {isModifier: false, short: Can be less than start/end (e.g. estimate), type: positiveInt, mustSupport: false, isSummary: false, index: 14}
  identifier: {isModifier: false, short: External Ids for this item, type: Identifier, mustSupport: false, array: true, isSummary: true, index: 0}
  basedOn:
    isModifier: false
    short: The service request this appointment is allocated to assess
    refers: ['http://hl7.org/fhir/StructureDefinition/ServiceRequest']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 19
  end: {isModifier: false, short: When appointment is to conclude, type: instant, mustSupport: false, isSummary: true, index: 13}
  reasonReference:
    isModifier: false
    short: Reason the appointment is to take place (resource)
    refers: ['http://hl7.org/fhir/StructureDefinition/Condition', 'http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation', 'http://hl7.org/fhir/StructureDefinition/Observation', 'http://hl7.org/fhir/StructureDefinition/Procedure']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 8
package_version: 4.3.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Appointment
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.3.0
required: [participant, status]