---
title: "List Who’s Out"
method: GET
path: "/api/v1/time_off/whos_out"
tags: ["Time Off", "Public API"]
---

# List Who’s Out

`GET /api/v1/time_off/whos_out`

Returns a date-sorted list of employees who are out and company holidays for the specified period. Defaults to today through 14 days out when dates are omitted. Results include both `timeOff` entries (employee requests) and `holiday` entries, each identified by `type`. An empty array may mean no one is out, or that no holidays have been configured in the BambooHR company calendar — holidays must be set up there before they appear here. The `filter: off` parameter applies only to employee time-off entries; holidays are independently filtered per-employee based on holiday visibility settings, and that filter is not disabled by `filter: off`.

OAuth Scopes: time_off

## Query parameters

- `start` string, date
- `end` string, date
- `filter` 'off'

## Headers

- `AcceptHeaderParameter` 'application/xml' | 'application/json'

## Response `200`

A date-sorted list of employees who are out and company holidays.

- object[]
  - `id` integer — The time off request ID or holiday ID.
  - `type` 'timeOff' | 'holiday' — Whether this entry is a time off request or a company holiday. Entries have two shapes depending on `type`: `timeOff` entries include `employeeId` and `name` (the employee's name); `holiday` entries include only `name` (the holiday name) and omit `employeeId`. Always check `type` before accessing `employeeId`.
  - `employeeId` integer — The internal employee ID. Only present for `timeOff` entries; omitted for `holiday` entries.
  - `name` string — For `timeOff` entries, the employee's name. For `holiday` entries, the holiday's name.
  - `start` string, date — Start date in YYYY-MM-DD format.
  - `end` string, date — End date in YYYY-MM-DD format.

## Other responses

- `401` — Unauthorized. Invalid API credentials.
- `403` — The Who's Out feature is disabled for this account.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)