---
title: "Get user unavailabilities"
method: GET
path: "/scheduler/v2/schedulers/user-unavailability"
tags: ["Schedule:v2:Schedulers:Unavailabilities (V2):Unavailabilities"]
---

# Get user unavailabilities

`GET /scheduler/v2/schedulers/user-unavailability`

Retrieve a list of user unavailabilities, approved time-off requests and assigned shifts

## Query parameters

- `userId` integer, required — The unique identifier of the user
- `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)

## Response `200`

Successful Response

- APIResponseV2GetUnavailabilitiesResponse
  - `requestId` string
  - `data` GetUnavailabilitiesResponse, required
    - `userUnavailabilities` UserUnavailabilityItem[], required — List of users with unavailabilities
      - `userId` integer, required — The unique identifier of the user
      - `unavailabilities` SingleAbsence[], required — List of approved unavailabilities
        - `id` string, nullable — The unique identifier of the unavailability
        - `type` 'unavailability' | 'timeOff', required
        - `startTime` TimestampWithTimezone, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `endTime` TimestampWithTimezone, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `note` string, required — The note of the unavailability
        - `policyName` string, nullable — The name of the policy (applicable only when unavailability type is timeOff)
        - `instanceId` integer, nullable — The schedule id of the unavailability (applicable only when unavailability type is unavailability)
      - `shifts` SingleShift[], required — List of assigned shifts
        - `id` string, required — The unique identifier of the shift
        - `startTime` TimestampWithTimezone, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `endTime` TimestampWithTimezone, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
        - `instanceId` integer, required — The unique identifier of the schedule instance

## 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)