Productive icon

Productive

Interact with the Productive API

Actions508

Timers → Get timers

AI-generated

Summary

Retrieve timers from Productive, optionally using filters, sorting, and pagination to customize the returned results.

Inputs

  • returnAll — Boolean flag to return all timer records or limit the response to a subset.
  • limit — Maximum number of timer records to return when not returning all results (default 50).
  • pageNumber — Page number to retrieve when not returning all results (default 1).
  • pageSize — Number of timer records per page when paginating (default 30, max 200).
  • filterQueryString — Literal filter query string to override other filters, supporting Productive API filter syntax.
  • filters — One or more field filters (Person ID, Started At, Stopped At, Time Entry ID) with operations (equals, contains, greater than, etc.) to filter the timers; ignored if filterQueryString is provided.
  • sortBy — Field to sort results by (Started At, Stopped At, or None).
  • sortOrder — Sort order direction, ascending or descending.

Output shape

a list of timer records as JSON objects

The output consists of zero or more timer objects matching the filters and pagination settings. The number of returned records depends on 'returnAll', pagination, and limit parameters.

Examples

Example 1: Retrieve all timers without filters

Set 'returnAll' to true.

Example 2: Retrieve up to 100 timers from page 2, filtered by Person ID equals '123'

Set 'returnAll' to false, 'limit' to 100, 'pageNumber' to 2, and add a filter on Person ID equals '123'.

Discussion