---
title: "List"
method: POST
path: "/management/v2/availability:list"
tags: ["Availability"]
---

# List

`POST /management/v2/availability:list`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/availability:list`
- Auth: API key in header `OAuth`

List.

## Request body

- AvailabilityListRequestData
  - `employees` integer[]
  - `start` string
  - `end` string

## Response `200`

A successful response.

- AvailabilityListResponse
  - `success` boolean
  - `data` ModelEmployeeAvailability[]
    - `employee` integer
    - `lastModifiedAt` string
    - `canAddAvailability` boolean
    - `hasSetUpAvailability` boolean
    - `oneOff` ModelOneOffAvailability[]
      - `date` string
      - `availability` ModelAvailabilityDetail[]
        - `id` integer
        - `tag` string
        - `kind` string
        - `start` string
        - `end` string
        - `comment` string
        - `isAllDay` boolean
        - `isOvernight` boolean
        - `recurrenceDetail` ModelRecurrenceDetail
          - `start` string
          - `end` string
          - `frequency` string
          - `interval` integer
          - `weekOfTheMonth` integer
          - `isEndingSoon` boolean
    - `dateOfMonthRecurrences` ModelDateOfMonthRecurrenceAvailability[]
      - `date` integer
      - `availability` ModelAvailabilityDetail[]
        - `id` integer
        - `tag` string
        - `kind` string
        - `start` string
        - `end` string
        - `comment` string
        - `isAllDay` boolean
        - `isOvernight` boolean
        - `recurrenceDetail` ModelRecurrenceDetail
          - `start` string
          - `end` string
          - `frequency` string
          - `interval` integer
          - `weekOfTheMonth` integer
          - `isEndingSoon` boolean
    - `weekdayRecurrences` ModelWeekdayRecurrenceAvailability[]
      - `dayOfWeek` string
      - `availability` ModelAvailabilityDetail[]
        - `id` integer
        - `tag` string
        - `kind` string
        - `start` string
        - `end` string
        - `comment` string
        - `isAllDay` boolean
        - `isOvernight` boolean
        - `recurrenceDetail` ModelRecurrenceDetail
          - `start` string
          - `end` string
          - `frequency` string
          - `interval` integer
          - `weekOfTheMonth` integer
          - `isEndingSoon` boolean
    - `timeZone` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)