GET PlanCare2Api/TeamAppointments/{appointmentId}?occurrenceRangeFrom={occurrenceRangeFrom}&occurrenceRangeUntil={occurrenceRangeUntil}

Obtains the specified team calendar appointment

Requires 'Start' permission for function TeamCalendar {C3F247FC-E417-49CB-81F0-823D1E835B68}

Request Information

URI Parameters

NameDescriptionTypeAdditional information
appointmentId

The identifier of the team calendar appointment.

integer

Required

occurrenceRangeFrom

The start of the range which is used to fetch the occurrences of a recurring appointment. When null, no occurrences are returned. Will be ignored for normal appointments

date

Required

occurrenceRangeUntil

The end of the range which is used to fetch the occurrences of a recurring appointment. When null, no occurrences are returned. Will be ignored for normal appointments.

date

Required

Body Parameters

None.

Response Information

Resource Description

The team appointment.

TeamAppointment
NameDescriptionTypeAdditional information
TeamCalendarId

The Id of the team calendar

integer

None

TeamCalendar

The name of the team calendar

string

None

ClientIds

The Id's of the clients.

Collection of integer

None

ShowInGroupCalendar

Determines whether the appointment is also shown in the GroupCalendar. Value is ignored when no ClientIds are specified

boolean

None

Clients

The clients in the team calendar. For reading purposes only.

Collection of NamedEntity

None

Start

The start date and time of the appointment.

date

Required

End

The end date and time of the appointment.

date

Required

Title

The subject of the appointment.

string

Required

Reason

The given reason when the appointment is completed or cancelled.

string

None

Status

Defines the status of the appointment. A Recurrence appointment will always have the status 'Created'.

PlannedItemStatus

None

StatusChangedByName

The name of the employee who changed the status of the appointment.

string

None

StatusChangedById

The id of the employee who changed the status of the appointment.

integer

None

CreatedByName

The name of the employee who created the appointment.

string

None

CreatedById

The id of the employee who created the appointment.

integer

None

Remarks

Remarks made to the appointment.

string

None

Id

The internal id of the appointment.

integer

Conditional Required: Only required for existing appointments

Location

The location of the appointment.

string

None

MovesToNextDay

Determines whether the appointment will be moved to the next day when not completed.

boolean

Required

IsAllDay

Is the appointment created as an all-day appointment.

boolean

Required

FriendlyRecurrenceInfo

The user friendly description of the recurrence for the appointment. This description is readonly. Only set when type is Recurrence.

string

None

RecurrenceInfo

Defines the recurrence for the appointment. Only set when type is Recurrence. When creating a appointment the RecurrenceStart property of RecurrenceInfo must be equal to the Start property. Can be left empty if you want to remove the recurrence.

RecurrenceInfo

None

RecurrenceOccurrences

The list of occurrences if the appointment is recurrent. Only occurrences within the provided range are returned Only set when type is Recurrence

Collection of OccurrenceAppointment

None

Type

Defines the type of the appointment, default type is normal

AppointmentType

None

ShiftId

The Id of the Shift

integer

None

ContractInfo

The appointment ContractInfo

string

None

Response Formats

application/json

Sample:

An exception has occurred while using the formatter 'JsonMediaTypeFormatter' to generate sample for media type 'application/json'. Exception message: Er is een uitzondering opgetreden van het type System.OutOfMemoryException.

text/json

Sample:

An exception has occurred while using the formatter 'JsonMediaTypeFormatter' to generate sample for media type 'text/json'. Exception message: Er is een uitzondering opgetreden van het type System.OutOfMemoryException.

application/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'application/xml'. Exception message: Er is een uitzondering opgetreden van het type System.OutOfMemoryException.

text/xml

Sample:

An exception has occurred while using the formatter 'XmlMediaTypeFormatter' to generate sample for media type 'text/xml'. Exception message: Er is een uitzondering opgetreden van het type System.OutOfMemoryException.