Time Entries API

Filter time entries by period, device, or case and retrieve them page by page.

Use the API to retrieve time entries for your own reporting. Requests require user authentication; only entries within your device and customer access are returned.

Endpoint

GET /api/time-entries?from=2026-08-01T00:00:00Z&to=2026-09-01T00:00:00Z&skip=0&take=50

All query parameters are optional and can be combined.

Parameter	Type	Required	Default	Meaning
`from` / `to`	Timestamp with time zone	No	No boundary	Entry start at or after `from`, strictly before `to`
`startedAt`	Timestamp with time zone	No	No boundary	Only entries starting strictly after this timestamp
`assetId`	UUID	No	All accessible devices	Limit to one device
`ticketId`	UUID	No	All accessible cases	Limit to one case
`search`	Text	No	No search	Search notes, users, and linked cases
`skip`	Integer	No	`0`	Entries to skip; negative values become `0`
`take`	Integer	No	`50`	Page size from `1` to `200`; other values use `50`
`sortDirection`	`Asc` or `Desc`	No	`Asc`	Sort by start time, then by ID for equal start times

Response and further pages

items contains the current page and total counts matching entries across all pages. Increase skip by the page size until you have retrieved all results, keeping the same filters. Do not use only the last startedAt value as the next cursor: several entries can share a start time.

Each entry includes its user, device, customer, start time, last contact, optional end time, status, note, and linked case. IDs and names may be absent depending on the assignment. Find the exact response schema in your instance's OpenAPI interface at /openapi/index.html.

totalDurationSeconds is a duration total only when ticketId is supplied. It covers all entries of that case visible to you, independently of search, date range, and page number. Without ticketId, it is 0. Open entries contribute time up to their last contact, not the current time.

Was this helpful?

Still need help? Ask the team