---
title: "GET Schedule Report"
method: GET
path: "/reports/schedule"
---

# GET Schedule Report

`GET /reports/schedule`

## Request

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

/reports/schedule
Permission level: 5

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `type` string, required
- `location` integer
- `schedule` string
- `employee` string
- `skill` string
- `with_statuses` integer
- `options` integer
- `deductbreaks` integer
- `remote_site` integer
- `include_emp_per_pos` integer
- `acknowledgement_status` string

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `82185` object
      - `id` string
      - `series` string
      - `created` string
      - `published` string
      - `edited` string
      - `deleted` string
      - `recurs` string
      - `recur_rule` string
      - `schedule` string
      - `store` string
      - `type` string
      - `needed` string
      - `have` 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
      - `start` string
      - `end` string
      - `length` string
      - `title` string
      - `location` string
      - `notes` string
      - `confirmed` string
      - `schedule_name` string
      - `schedule_color` string
      - `employee` unknown[]
        - unknown
    - `93829` object
      - `id` string
      - `series` string
      - `created` string
      - `published` string
      - `edited` string
      - `deleted` string
      - `recurs` string
      - `recur_rule` string
      - `schedule` string
      - `store` string
      - `type` string
      - `needed` string
      - `have` 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
      - `start` string
      - `end` string
      - `length` string
      - `title` string
      - `location` string
      - `notes` string
      - `confirmed` string
      - `schedule_name` string
      - `schedule_color` string
      - `employee` unknown[]
        - unknown
  - `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/reports/schedule/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)
