---
title: "Get availability in date period"
method: POST
path: "/employees/availability"
---

# Get availability in date period

`POST /employees/availability`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/employees/availability`
- Auth: API key in query parameter `access_token`

/employees/availability

## Query parameters

- `access_token` string, required

## Headers

- `Content-Type` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `start_date` string, required: DateTime in ISO 8601 format, example: 2020-05-15T00:00:00-05:00
  - `end_date` string, required: DateTime in ISO 8601 format, example: 2020-05-31T00:00:00-05:00
  - `employee_ids` string, required: Comma separated values. Example:<br>4807410,1417042,2834065
  - `status` integer: Pending - 0, Approved - 1, Rejected - 2
  - `fields` object
    - `availability` string: Filters key values from resource. Example:<br> id,start_time,end_time,employee_id

## Response `200`

200

- object
  - `status` integer
  - `data` object[]
    - `id` string
    - `status` integer
    - `employee_id` integer
    - `company_id` integer
    - `start_time` string
    - `end_time` string
    - `series_id` string
    - `title` string
    - `note` string
    - `created_at` string
    - `created_by` integer
    - `updated_at` string
    - `updated_by` unknown
    - `deleted_at` unknown
    - `deleted_by` unknown
    - `rejected_note` unknown
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/employees/availability/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
