list-calendar-event-instances
Expand recurring Microsoft 365 calendar events into individual occurrences within a specified date range to view all scheduled instances.
Instructions
The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions modified, but doesn't include occurrences canceled from the series. Navigation property. Read-only. Nullable.
š” TIP: Expand a recurring event into individual instances within a date range. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Use this to see all occurrences of a recurring event.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| startDateTime | Yes | The start date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T19:00:00-08:00 | |
| endDateTime | Yes | The end date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00 | |
| top | No | Show only the first n items | |
| skip | No | Skip the first n items | |
| search | No | Search items by search phrases | |
| filter | No | Filter items by property values | |
| count | No | Include count of items | |
| orderby | No | Order items by property values | |
| select | No | Select properties to be returned | |
| expand | No | Expand related entities | |
| calendarId | Yes | Path parameter: calendarId | |
| eventId | Yes | Path parameter: eventId | |
| fetchAllPages | No | Automatically fetch all pages of results | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication | |
| timezone | No | IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC. | |
| expandExtendedProperties | No | When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events. |