---
title: "List Breaks for Break Policy"
method: GET
path: "/api/v1/time-tracking/break-policies/{id}/breaks"
tags: ["Meal & Rest Breaks", "Public API"]
---

# List Breaks for Break Policy

`GET /api/v1/time-tracking/break-policies/{id}/breaks`

Returns a paginated list of breaks belonging to the specified break policy. Supports OData v4 filtering.

OAuth Scopes: time_tracking:breaks

## Path parameters

- `id` string, uuid, required

## Query parameters

- `offset` integer
- `limit` integer
- `filter` string

## Response `200`

Successfully retrieved breaks for the specified break policy

- object — Additional data for paginated responses
  - `meta` object — Pagination metadata
    - `totalItems` integer, required
    - `offset` integer, required
    - `limit` integer, required
  - `_links` object — Pagination links
    - `prev` object, nullable, required — Link object for the previous page, or null if on the first page
      - `href` string — Full URL for the previous page
    - `next` object, nullable, required — Link object for the next page, or null if on the last page
      - `href` string — Full URL for the next page
  - `data` TimeTrackingTimeTrackingBreakV1[] — Collection of time tracking breaks
    - `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
    - `availabilityMinHoursWorked` number, float, nullable — Minimum hours that must be worked before the break can be taken
    - `availabilityMaxHoursWorked` number, float, nullable — Maximum hours that can be worked before the break must be taken
    - `availabilityStartTime` string, time, nullable — Earliest time the break can be taken (HH:MM format)
    - `availabilityEndTime` string, time, nullable — Latest time the break can be taken (HH:MM format)
    - `createdAt` string, date-time — ISO 8601 timestamp when the break was created
    - `updatedAt` string, date-time, nullable — ISO 8601 timestamp when the break was last updated
    - `deletedAt` string, date-time, nullable — ISO 8601 timestamp when the break was deleted

## Other responses

- `403` — Forbidden
- `422` — Invalid input

---

[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/versions/19ebf391a399/schema)