---
title: "List Employee Break Availabilities"
method: GET
path: "/api/v1/time-tracking/employees/{id}/break-availabilities"
tags: ["Meal & Rest Breaks", "Public API"]
---

# List Employee Break Availabilities

`GET /api/v1/time-tracking/employees/{id}/break-availabilities`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/time-tracking/employees/{id}/break-availabilities`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_tracking:breaks`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/time-tracking/employees/:id/break-availabilities/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves break availability information for an employee. Requires permission to view the target employee in addition to time-tracking-break access.

OAuth Scopes: time_tracking:breaks

## Path parameters

- `id` integer, required

## Query parameters

- `effective` string

## Response `200`

Successfully retrieved break availabilities for the specified employee

- TimeTrackingTimeTrackingBreakAvailabilityV1[]: Collection of time tracking break availabilities
  - `id` string, uuid: The unique identifier for the time tracking break
  - `name` string: The name of the break
  - `policyId` string, uuid: The unique identifier of the break policy this break belongs to
  - `paid` boolean: Whether the break is paid
  - `duration` integer: Duration of the break in minutes
  - `availabilityType` 'anytime' | 'hours_worked' | 'time_of_day': When the break is available to be taken
  - `calculatedAt` string, date-time: When the break availability was calculated
  - `effectiveAt` string, date-time: Timestamp that all time-based calculations are evaluated relative to.
  - `timezone` string: The timezone the break availability is calculated in
  - `recordedDuration` integer: The duration of the break that has been recorded so far
  - `available` boolean: Whether the break is currently available to be taken
  - `availableAfterMinutesWorked` integer, nullable: Minutes of work after which the break becomes available
  - `availableIn` integer, nullable: Minutes until the break becomes available
  - `unavailableIn` integer, nullable: Minutes until the break becomes unavailable
  - `availableAt` string, date-time, nullable: When the break is or becomes available
  - `unavailableAt` string, date-time, nullable: When the break is or becomes unavailable

## Other responses

- `403`: Forbidden - insufficient permissions to view this employee or break settings.
- `422`: Invalid input

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)