---
title: "List Time Tracking Time Clocks"
method: GET
path: "/api/v1/time-tracking/time-clocks"
tags: ["Time Tracking", "Public API"]
---

# List Time Tracking Time Clocks

`GET /api/v1/time-tracking/time-clocks`

## Request

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

Returns a paginated list of the company's time tracking time clocks. Supports an OData-style `filter`, an `orderBy` sort expression, and `select` sparse fieldsets. Results are sorted by name ascending when `orderBy` is omitted; name ordering is case-insensitive. Filtering and sorting are applied in memory over the cached GT Connect list (partner ordering is not relied on). A company with no GT Clocks connected returns an empty list, not a 404. Device health flags are reported as null while device status is temporarily unavailable. Pagination is page-based via `page` and `pageSize` (defaults: page 1, pageSize 20, minimum 10, maximum 100).

OAuth Scopes: time_tracking:time_clocks

## Query parameters

- `filter` string
- `orderBy` string
- `select` string
- `page` integer
- `pageSize` integer

## Response `200`

A paginated list of time clocks.

- object: Pagination envelope shared by page-based paginated Time Tracking endpoints.
  - `meta` object: Pagination metadata.
    - `page` integer, required
    - `pageSize` integer, required
    - `totalPages` integer, required
    - `totalItems` integer, required
  - `_links` object: Pagination links. Keys are omitted when there is no previous/next page.
    - `prev` object: Link object for the previous page. Omitted on the first page.
      - `href` string
    - `next` object: Link object for the next page. Omitted on the last page.
      - `href` string
  - `data` TimeTrackingTimeTrackingTimeClockV1[]: Collection of time tracking time clocks.
    - `id` string, uuid: The unique identifier for the time clock.
    - `name` string: The name of the time clock.
    - `serialNumber` string: The manufacturer serial number of the device.
    - `type` 'TIME_CLOCK' | 'TIME_CLOCK_PLUS': The hardware model of the time clock.
    - `online` boolean, nullable: Whether the device is reachable. Null when device status is temporarily unavailable.
    - `configOnline` boolean, nullable: Whether the device is receiving configuration updates. Null when device status is temporarily unavailable.
    - `dataOnline` boolean, nullable: Whether the device is sending clock data. Null when device status is temporarily unavailable.
    - `firmwareOnline` boolean, nullable: Whether the device is receiving firmware updates. Null when device status is temporarily unavailable.
    - `timezone` string: IANA timezone name the device records clock entries in.

## Other responses

- `401`: Unauthorized. Missing or invalid authentication.
- `403`: Forbidden. Insufficient permissions.
- `422`: Invalid query parameters (e.g., invalid `page`, `pageSize`, `filter`, `orderBy`, or `select`).
- `503`: Time clock data is temporarily unavailable. Retry after the interval given in the Retry-After header.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/time-tracking/time-clocks/get.md)

---

[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)