List Time Off Entries

Retrieve paginated time off entries from a Microsoft Teams schedule via GET request.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-time-off-entries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: List Time Off Entries
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/list-times-off
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-time-off-entries

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users easily view and manage time off entries within a Microsoft Teams schedule, streamlining absence tracking.

Core Features & Use Cases

  • List Time Off: Retrieve all time off entries for a specific team.
  • Pagination: Control the number of entries returned per page using $top.
  • Filtering: Narrow down results by user or date range with $filter.
  • Use Case: A manager needs to quickly see all planned absences for their team next month. They can use this Skill, providing the team ID and a date filter, to get a clear overview.

Quick Start

List the first 10 time off entries for the team with ID 'e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c'.

Frequently Asked Questions about List Time Off Entries

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list Microsoft Teams time off entries for my team schedule?

To list Microsoft Teams time off entries, you retrieve a paginated list from a specified team schedule using a GET request to the `/teams/{team-id}/schedule/timesOff` API endpoint. This provides a clear overview of planned absences.

Can I filter Teams schedule absences by specific users and dates?

Yes, you can filter Teams schedule absences by specific users and date ranges using the `$filter` query parameter. This narrows down the retrieved time off entries to match your exact scheduling requirements.

How do I control the number of time off entries returned from the Teams API?

You control the number of time off entries returned from the Teams API by using pagination controls. Specifically, you use the `$top` parameter to define the page size and apply pagination logic for efficient data retrieval.

Do I need a specific team ID to retrieve time off schedules from Microsoft Teams?

Yes, you need a specific Microsoft Teams team ID to retrieve time off schedules. The API requires this unique identifier in the endpoint path `/teams/{team-id}/schedule/timesOff` to locate and fetch the correct absence data.

What is the best way to track upcoming team absences in a Microsoft Teams schedule?

The best way to track upcoming team absences is to retrieve time off entries via the Teams API while applying a date range filter. This allows managers to quickly see all planned absences for their team next month.