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
| Name | Description | Type | Additional 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| Name | Description | Type | Additional 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 |
| WeekPlanningId |
The Id of the WeekPlanning. |
integer |
None |
Response Formats
application/json, text/json
{
"TeamCalendarId": 1,
"TeamCalendar": "sample string 2",
"ClientIds": [
1,
2
],
"ShowInGroupCalendar": true,
"Clients": [
{
"$id": "2",
"Id": 1,
"Name": "sample string 2"
},
{
"$ref": "2"
}
],
"Start": "2026-05-26T21:05:51.6198236+02:00",
"End": "2026-05-26T21:05:51.6198236+02:00",
"Title": "sample string 6",
"Reason": "sample string 7",
"Status": 0,
"StatusChangedByName": "sample string 8",
"StatusChangedById": 9,
"CreatedByName": "sample string 10",
"CreatedById": 11,
"Remarks": "sample string 12",
"Id": 13,
"Location": "sample string 14",
"MovesToNextDay": true,
"IsAllDay": true,
"FriendlyRecurrenceInfo": "sample string 17",
"RecurrenceInfo": {
"$id": "3",
"OccurrenceCount": 1,
"Periodicity": 1,
"Range": 0,
"Interval": 0,
"WeekDays": 1,
"RecurrenceStart": "2026-05-26T21:05:51.6198236+02:00",
"RecurrenceEnd": "2026-05-26T21:05:51.6198236+02:00",
"Month": 1,
"DayNumber": 1,
"WeekOfMonth": 0
},
"RecurrenceOccurrences": [
{
"$id": "4",
"Id": 1,
"Start": "2026-05-26T21:05:51.6198236+02:00",
"End": "2026-05-26T21:05:51.6198236+02:00",
"Title": "sample string 4",
"Location": "sample string 5",
"ParentId": 6,
"OccurrenceIndex": 7,
"Type": 0,
"Reason": "sample string 8",
"Status": 0,
"StatusChangedByName": "sample string 9",
"StatusChangedById": 10,
"CreatedByName": "sample string 11",
"CreatedById": 12,
"Remarks": "sample string 13"
},
{
"$ref": "4"
}
],
"Type": 0,
"ShiftId": 1,
"ContractInfo": "sample string 18",
"WeekPlanningId": 1
}