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

# List Configurations

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

## Request

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

Returns a paginated list of time tracking configurations. Both GLOBAL and GROUP configurations are returned; soft-deleted configurations are never returned. Supports an OData-style `filter`, an `orderBy` sort expression, and `select` sparse fieldsets. Pagination is page-based via `page` and `pageSize` (defaults: page 1, pageSize 20, max 100).

OAuth Scopes: time_tracking:configurations

## Query parameters

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

## Response `200`

A paginated list of time tracking configurations.

- object: Pagination envelope shared by paginated time tracking configuration 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` TimeTrackingTimeTrackingConfigurationV1[]: Collection of time tracking configurations.
    - `id` integer: The ID of the configuration.
    - `name` string: The configuration name. Unique per company.
    - `type` 'GLOBAL' | 'GROUP': The configuration type. Read-only. Exactly one GLOBAL configuration exists per company; all customer-created configurations are GROUP.
    - `timesheetType` 'CLOCK' | 'SINGLE' | 'MULTIPLE' | 'HOUR': How time is logged.
    - `workWeekStartsOn` 'SUNDAY' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY': Day of week the work week starts.
    - `approverType` 'REPORTS_TO' | 'SPECIFIC_PERSON', nullable: Who approves timesheets. REPORTS_TO is the employee's manager; SPECIFIC_PERSON is a designated user. Null when no valid approver is configured and the settings need to be re-saved.
    - `approverUserId` integer, nullable: The user ID of the approver. Populated when approverType is SPECIFIC_PERSON; null otherwise.
    - `approvalCutoff` string: Time of day by which timesheets must be approved, in 24-hour HH:MM format.
    - `approvalCutoffDays` integer: Number of days before the pay date the cutoff applies.
    - `clockInSchedulePolicy` 'ANYTIME' | 'SHIFT_REQUIRED': When scheduled employees can clock in.
    - `restrictWebClockActions` boolean: When true, removes the time clock from bamboohr.com for employees in this configuration.
    - `mobileEnabled` boolean: When true, employees can log time using the BambooHR mobile app.
    - `geolocationEnabled` boolean: When true, employee location is required when clocking in/out via mobile. Only meaningful when mobileEnabled is true.
    - `customOvertimeEnabled` boolean: When false, standard U.S. and Canada overtime rules apply. When true, the daily/weekly overtime fields are honored.
    - `overtimeDailyHours` string, nullable: Daily overtime threshold in hours as a decimal string. Honored only when customOvertimeEnabled is true; null otherwise.
    - `overtimeDailyDoubleHours` string, nullable: Daily double-overtime threshold in hours as a decimal string. Honored only when customOvertimeEnabled is true; null otherwise.
    - `overtimeWeeklyHours` string, nullable: Weekly overtime threshold in hours as a decimal string. Honored only when customOvertimeEnabled is true; null otherwise.
    - `employeeIds` integer[]: Read-only array of employee IDs currently enrolled in this configuration.
    - `createdAt` string, date-time: ISO 8601 timestamp when the configuration was created.
    - `updatedAt` string, date-time, nullable: ISO 8601 timestamp when the configuration was last updated.
    - `deletedAt` string, date-time, nullable: ISO 8601 timestamp when the configuration was soft-deleted. Null for active configurations.

## 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`).

## Changes

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

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/time-tracking/configurations/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)