---
title: "GET Future Availability"
method: GET
path: "/employees/{user}/availabilities/future"
---

# GET Future Availability

`GET /employees/{user}/availabilities/future`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/employees/{user}/availabilities/future`
- Auth: API key in query parameter `access_token`

/employees/:user/availabilities/future
Permission level: 5

## Path parameters

- `user` integer, required

## Query parameters

- `approved` integer
- `start_date` string, date
- `end_date` string, date

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `4159100` object
      - `date` object
        - `id` integer
        - `month` integer
        - `day` integer
        - `wday` integer
        - `year` integer
        - `weekday` string
        - `mname` string
        - `week` integer
        - `dayid` integer
        - `timeid` integer
        - `timeid_exact` integer
        - `formatted` string
        - `iso8601` string
        - `time` string
        - `timestamp` integer
        - `hours` integer
        - `minutes` integer
        - `seconds` integer
        - `date` string
        - `day_of_year` string
        - `week_adjusted` integer
        - `sp_wday` integer
      - `availability` object
        - `61` object
          - `date` string
          - `time` string
          - `flag` string
        - `62` object
          - `date` string
          - `time` string
          - `flag` string
        - `63` object
          - `date` string
          - `time` string
          - `flag` string
        - `64` object
          - `date` string
          - `time` string
          - `flag` string
        - `65` object
          - `date` string
          - `time` string
          - `flag` string
        - `66` object
          - `date` string
          - `time` string
          - `flag` string
        - `67` object
          - `date` string
          - `time` string
          - `flag` string
        - `68` object
          - `date` string
          - `time` string
          - `flag` string
      - `approved` string
      - `approved_by` string
      - `times` string
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/employees/:user/availabilities/future/get.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)
