---
title: "GET Weekly Availability"
method: GET
path: "/employees/{user}/availabilities/weekly"
---

# GET Weekly Availability

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

## Request

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

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

## Path parameters

- `user` integer, required

## Query parameters

- `approved` integer
- `day` integer
- `timeframe` integer

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `effective` string
    - `type` integer
    - `grid` object
      - `id` string
      - `day` string
      - `availability` object
        - `5` object
          - `flag` string
          - `approved` unknown
        - `6` object
          - `flag` string
          - `approved` unknown
        - `7` object
          - `flag` string
          - `approved` unknown
        - `8` object
          - `flag` string
          - `approved` unknown
        - `9` object
          - `flag` string
          - `approved` unknown
        - `10` object
          - `flag` string
          - `approved` unknown
        - `11` object
          - `flag` string
          - `approved` unknown
        - `12` object
          - `flag` string
          - `approved` unknown
        - `13` object
          - `flag` string
          - `approved` unknown
        - `14` object
          - `flag` string
          - `approved` unknown
        - `15` object
          - `flag` string
          - `approved` unknown
        - `16` object
          - `flag` string
          - `approved` unknown
        - `17` object
          - `flag` string
          - `approved` unknown
        - `18` object
          - `flag` string
          - `approved` unknown
        - `19` object
          - `flag` string
          - `approved` unknown
        - `20` object
          - `flag` string
          - `approved` unknown
        - `21` object
          - `flag` string
          - `approved` unknown
        - `22` object
          - `flag` string
          - `approved` unknown
        - `23` object
          - `flag` string
          - `approved` unknown
        - `24` object
          - `flag` string
          - `approved` unknown
        - `25` object
          - `flag` string
          - `approved` unknown
        - `26` object
          - `flag` string
          - `approved` unknown
        - `27` object
          - `flag` string
          - `approved` unknown
        - `28` object
          - `flag` string
          - `approved` unknown
        - `29` object
          - `flag` string
          - `approved` unknown
        - `30` object
          - `flag` string
          - `approved` unknown
        - `31` object
          - `flag` string
          - `approved` unknown
        - `32` object
          - `flag` string
          - `approved` unknown
        - `33` object
          - `flag` string
          - `approved` unknown
        - `34` object
          - `flag` string
          - `approved` unknown
        - `35` object
          - `flag` string
          - `approved` unknown
        - `36` object
          - `flag` string
          - `approved` unknown
        - `37` object
          - `flag` string
          - `approved` unknown
        - `38` object
          - `flag` string
          - `approved` unknown
        - `39` object
          - `flag` string
          - `approved` unknown
        - `40` object
          - `flag` string
          - `approved` unknown
        - `41` object
          - `flag` string
          - `approved` unknown
        - `42` object
          - `flag` string
          - `approved` unknown
        - `43` object
          - `flag` string
          - `approved` unknown
        - `44` object
          - `flag` string
          - `approved` unknown
  - `metadata` unknown[]
    - unknown
  - `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/weekly/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)
