---
title: "Get schedule unavailabilities"
method: GET
path: "/scheduler/v1/schedulers/{schedulerId}/unavailabilities"
tags: ["Schedule:v1:Schedulers:Schedule:Schedule Unavailabilities"]
---

# Get schedule unavailabilities

`GET /scheduler/v1/schedulers/{schedulerId}/unavailabilities`

Retrieve a list of unavailabilities under a specific schedule filtered by date range. The response is paginated and can be filtered by user ID.

## Path parameters

- `schedulerId` integer, required — The unique identifier of the schedule

## Query parameters

- `startTime` integer, required — The start time to filter by in Unix format (in seconds)
- `endTime` integer, required — The end time to filter by in Unix format (in seconds)
- `limit` integer — The maximum number of results to display per page
- `offset` integer — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results

## Response `200`

Successful Response

- PaginatedBaseResponseV2UnavailabilitiesListGetResponse
  - `requestId` string
  - `data` UnavailabilitiesListGetResponse, required
    - `unavailabilities` SchedulerUnavailabilityResponse[], required — The list of the unavailabilities
      - `id` string, required — The ID of the unavailability
      - `userId` integer, required — The ID of the user to which the unavailability is assigned
      - `isAllDay` boolean, required — Whether the unavailability is for the entire day
      - `unavailabilityDate` string, required — The date of the unavailability in ISO format (YYYY-MM-DD)
      - `startTime` string, nullable — The start time of the unavailability in ISO format (HH:MM:SS)
      - `endTime` string, nullable — The end time of the unavailability in ISO format (HH:MM:SS)
      - `timezone` string, required — The timezone of the unavailability in Tz format (e.g. America/New_York)
      - `note` string, nullable — Optional note with additional details about the unavailability
  - `paging` PagingResponseModelV2, required
    - `offset` integer, required — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results
    - `total` integer, nullable — Total number of resources matching the request, ignoring pagination. Use this to retrieve the full count without paginating through every page. Only populated by endpoints that compute it.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)