---
title: "GET Fill"
method: GET
path: "/shifts/fill"
---

# GET Fill

`GET /shifts/fill`

## Request

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

/shifts/fill
Permission level: 4

## Query parameters

- `shifts` string, required
- `fill_count` integer
- `fill_slots` integer
- `dissalow_openslots` integer

## Response `200`

200

- object
  - `status` integer
  - `data` object[]
    - `id` string
    - `created` string
    - `published` string
    - `edited` string
    - `deleted` string
    - `schedule` string
    - `type` string
    - `needed` string
    - `working` string
    - `user` string
    - `start_date` object
      - `id` string
      - `month` string
      - `day` string
      - `year` string
      - `weekday` string
      - `mname` string
      - `week` string
      - `dayid` integer
      - `formatted` string
    - `end_date` object
      - `id` string
      - `month` string
      - `day` string
      - `year` string
      - `weekday` string
      - `mname` string
      - `week` string
      - `dayid` integer
      - `formatted` string
    - `length` integer
    - `title` string
    - `location` string
    - `notes` string
    - `confirmed` string
    - `perms` integer
    - `paidtime` integer
    - `start_time` object
      - `id` string
      - `time` string
    - `end_time` object
      - `id` string
      - `time` string
    - `schedule_name` string
    - `employees` object[]
      - `id` string
      - `name` string
      - `status` string
      - `wage` string
      - `notified_day` string
      - `notified_hour` string
      - `last_active` string
      - `rate` string
      - `ratecard` string
      - `cost` integer
    - `cost` object
      - `staff` integer
      - `hours` integer
      - `dollars` integer
    - `repeats` string
  - `token` string

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/shifts/fill/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)
