---
title: "Finds daily time clocks based on search parameters"
method: POST
path: "/api/time-clock-timers/list"
tags: ["Time Clock Timers"]
---

# Finds daily time clocks based on search parameters

`POST /api/time-clock-timers/list`

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending' — Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- TimeClockRequestListTimeClocksParameters — Parameters used for searching time clocks
  - `userId` string, nullable — Filter timers based on who started it
  - `startedDateRange` DtoCommonDateRangeFilter — Date range used for filters
    - `start` string, date-time, nullable — Inclusive start date to filter by
    - `end` string, date-time, nullable — Inclusive end date to filter by
  - `stoppedDateRange` DtoCommonDateRangeFilter — Date range used for filters
    - `start` string, date-time, nullable — Inclusive start date to filter by
    - `end` string, date-time, nullable — Inclusive end date to filter by
  - `runningTimersOnly` boolean, nullable — Filter to only open timers

## Response `200`

OK

- DtoPagedResultDtoTimeClockDto — Paged result
  - `data` TimeClockDto[], required — The data
    - `id` string, nullable — The timer identifier
    - `startedById` string, nullable — The user identifier who started the timer
    - `startedOnUtc` string, date-time, nullable — When the timer was started in UTC time.
    - `stoppedOnUtc` string, date-time, nullable — When the timer was stopped in UTC time.
    - `type` 'setup' | 'run' | 'clockIn' | 'break' | 'labor' | 'machine'
    - `isRunning` boolean — Whether the timer is running or not
    - `reasonCodeId` string, nullable — The tag identifier for the reason code
    - `clockInCodeId` string, nullable — The tag identifier for the clock in code
  - `page` integer, required — The 1-indexed page
  - `pageSize` integer, required — The page size
  - `totalCount` integer, required — The total count of records
  - `totalPages` integer, required — The total pages
  - `hasPreviousPage` boolean, required — True if there is a previous page
  - `hasNextPage` boolean, required — True if there is a next page

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/revisions/1b5649cff14a/schema)