---
type: "resource-definitions"
title: "Schedule Definitions"
resource: "Schedule"
---

# Schedule Definitions

<a id="Schedule"></a>

## Schedule
A container for slots of time that may be available for booking appointments

**Definition:** A container for slots of time that may be available for booking appointments.

**Aliases:** Availability

**Cardinality:** 0..*

**Mappings:** rim=n/a; ical=BEGIN:VFREEBUSY  ???  END:VFREEBUSY (If your fhir server provides this information via calDAV, then you may want to include addressing information in a URL section, and with the search, a DTSTART and DTEND component can be included to indicate the range of time that has been covered in the collection of slots, where these overlap the resources period values. For all slots that reference this resource, include a FREEBUSY row for each slot); w5=workflow.scheduling


<a id="Schedule.identifier"></a>

## Schedule.identifier
External Ids for this item

**Definition:** External Ids for this item.

**Cardinality:** 0..*

**Type:** [Identifier](/Identifier)

**Summary:** true

**Mappings:** w5=FiveWs.identifier; ical=UID


<a id="Schedule.active"></a>

## Schedule.active
Whether this schedule is in active use

**Definition:** Whether this schedule record is in active use or should not be used (such as was entered in error).

**Comments:** This element is labeled as a modifier because it may be used to mark that the resource was created in error.

**Meaning if Missing:** This resource is generally assumed to be active if no value is provided for the active element

**Cardinality:** 0..1

**Type:** [boolean](/boolean)

**Summary:** true

**Is Modifier:** true (Reason: This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid)

**Mappings:** w5=FiveWs.status


<a id="Schedule.serviceCategory"></a>

## Schedule.serviceCategory
High-level category

**Definition:** A broad categorization of the service that is to be performed during this appointment.

**Cardinality:** 0..*

**Type:** [CodeableConcept](/CodeableConcept)

**Binding:** example:[service-category](/valueset-service-category)

**Summary:** true

**Mappings:** w5=FiveWs.class


<a id="Schedule.serviceType"></a>

## Schedule.serviceType
Specific service

**Definition:** The specific service that is to be performed during this appointment.

**Cardinality:** 0..*

**Type:** [CodeableReference](/CodeableReference)

**Binding:** example:[service-type](/valueset-service-type)

**Summary:** true

**Mappings:** w5=FiveWs.class; ical=n/a


<a id="Schedule.specialty"></a>

## Schedule.specialty
Type of specialty needed

**Definition:** The specialty of a practitioner that would be required to perform the service requested in this appointment.

**Cardinality:** 0..*

**Type:** [CodeableConcept](/CodeableConcept)

**Binding:** example:[c80-practice-codes](/valueset-c80-practice-codes)

**Summary:** true

**Mappings:** w5=FiveWs.class


<a id="Schedule.name"></a>

## Schedule.name
Human-readable label

**Definition:** Further description of the schedule as it would be presented to a consumer while searching.

**Comments:** This MAY be used to describe what the schedule is for where it is clearer than just the name of the single actor.

**Cardinality:** 0..1

**Type:** [string](/string)

**Summary:** true


<a id="Schedule.actor"></a>

## Schedule.actor
Resource(s) that availability information is being provided for

**Definition:** Slots that reference this schedule resource provide the availability details to these referenced resource(s).

**Comments:** The capacity to support multiple referenced resource types should be used in cases where the specific resources themselves cannot be scheduled without the other, and thus only make sense to the system exposing them as a group. Common examples of this are where the combination of a practitioner and a room (Location) are always required by a system.

**Cardinality:** 1..*

**Type:** Reference([Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [CareTeam](/CareTeam), [RelatedPerson](/RelatedPerson), [Device](/Device), [HealthcareService](/HealthcareService), [Location](/Location))

**Summary:** true

**Mappings:** w5=FiveWs.subject; ical=ATTENDEE:MAILTO:john_public@host2.com This can be populated with a value from the referenced resource


<a id="Schedule.planningHorizon"></a>

## Schedule.planningHorizon
Period of time covered by schedule

**Definition:** The period of time that the slots that reference this Schedule resource cover (even if none exist). These  cover the amount of time that an organization's planning horizon; the interval for which they are currently accepting appointments. This does not define a "template" for planning outside these dates.

**Cardinality:** 0..1

**Type:** [Period](/Period)

**Summary:** true

**Mappings:** w5=FiveWs.planned; ical=DTSTART:20131201T003000Z DTEND:2014030101T003000Z


<a id="Schedule.comment"></a>

## Schedule.comment
Comments on availability

**Definition:** Comments on the availability to describe any extended information. Such as custom constraints on the slots that may be associated.

**Cardinality:** 0..1

**Type:** [markdown](/markdown)

**Mappings:** ical=COMMENT:(comment) If there is no comment, then the line can be excluded from the iCalendar entry