---
title: "List Break Assessments"
method: GET
path: "/api/v1/time-tracking/break-assessments"
tags: ["Meal & Rest Breaks", "Public API"]
---

# List Break Assessments

`GET /api/v1/time-tracking/break-assessments`

Returns a paginated list of break assessments. A break assessment records whether an employee complied with their assigned break policy for a given day, along with any violations. Use the `filter` parameter to scope results by employee, date, result, or other fields. Use `offset` and `limit` for pagination; `limit` defaults to 100 and may not exceed 500.

OAuth Scopes: time_tracking:breaks

## Query parameters

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

## Response `200`

A list of paginated break assessments

- 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` TimeTrackingTimeTrackingBreakAssessmentV1[] — Collection of time tracking break assessments
    - `id` string, uuid — The unique identifier for the time tracking break assessment
    - `breakId` string, uuid — The unique identifier of the break
    - `employeeId` integer — The id of the employee
    - `employeeTimesheetId` integer — The id of the employee timesheet
    - `date` string, date — The date of the break assessment
    - `timezone` string — The timezone of the break assessment
    - `result` 'compliant' | 'violation' | 'waived' — The result of the break assessment
    - `availableYmdt` string, date-time, nullable — ISO 8601 timestamp when the break became available
    - `unavailableYmdt` string, date-time, nullable — ISO 8601 timestamp when the break became unavailable
    - `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
    - `violations` TimeTrackingTimeTrackingBreakAssessmentViolationV1[] — Violations associated with the assessment
      - `assessmentId` string, uuid — The unique identifier for the time tracking break assessment.
      - `type` 'break_started_early' | 'break_started_late' | 'break_ended_early' | 'break_ended_late' | 'break_missed' — The type of the violation
      - `employeeTimesheetClockEntryId` number, nullable — The id of the employee timesheet clock entry
      - `amount` number, nullable — The amount of the violation
    - `clockEntryIds` integer[] — Clock entry ids associated with the time tracking break assessment
    - `expectedDuration` integer, nullable — The expected duration of the break in minutes
    - `recordedDuration` integer, nullable — The recorded duration of the break in minutes
    - `durationDifference` integer, nullable — The difference between the expected and recorded duration in minutes

## 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/revisions/19ebf391a399/schema)