Skip to content

List Timers

GET
/users/{user_id}/tracking-timers
curl --request GET \
--url https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tracking-timers

All of the user’s running timers, most recently started first.

user_id
required
User Id
string format: uuid

Successful Response

Media typeapplication/json
Response List Timers Users User Id Tracking Timers Get
Array<object>
TrackingTimerRead
object
category_id
required
Any of:
string format: uuid
created_at
required
Created At
string format: date-time
id
required
Id
string format: uuid
label
required
Any of:
string
started_at
required
Started At
string format: date-time
updated_at
required
Updated At
string format: date-time
user_id
required
User Id
string format: uuid
Examplegenerated
[
{
"category_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"created_at": "2026-04-15T12:00:00Z",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"label": "example",
"started_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z",
"user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
]

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}