Zeiteinträge abrufen

Zeiteinträge nach Zeitraum, Gerät oder Meldung filtern und seitenweise abrufen.

Über die API kannst du Zeiteinträge für eigene Auswertungen abrufen. Die Anfrage benötigt eine Benutzerauthentifizierung; du erhältst nur Einträge innerhalb deines Geräte- und Kundenzugriffs.

Endpunkt

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

Alle Abfrageparameter sind optional und kombinierbar.

ParameterTypPflichtStandardBedeutung
from / toZeitstempel mit ZeitzoneNeinKeine GrenzeBeginn des Eintrags ab from einschließlich und vor to ausschließlich
startedAtZeitstempel mit ZeitzoneNeinKeine GrenzeNur Einträge mit einem Beginn strikt nach diesem Zeitpunkt
assetIdUUIDNeinAlle zugänglichen GeräteAuf ein Gerät eingrenzen
ticketIdUUIDNeinAlle zugänglichen MeldungenAuf eine Meldung eingrenzen
searchTextNeinKeine SucheIn Notizen, Benutzern und verknüpften Meldungen suchen
skipGanzzahlNein0Anzahl zu überspringender Einträge; negative Werte werden zu 0
takeGanzzahlNein50Seitengröße von 1 bis 200; andere Werte verwenden 50
sortDirectionAsc oder DescNeinAscNach Beginn sortieren, bei gleichem Beginn nach ID

Antwort und weitere Seiten

items enthält die aktuelle Seite, total die Anzahl passender Einträge über alle Seiten. Erhöhe skip um die Seitengröße, bis du alle Ergebnisse abgerufen hast. Behalte dabei dieselben Filter bei. Verwende nicht ausschließlich den letzten startedAt-Wert als nächsten Cursor: Mehrere Einträge können denselben Beginn haben.

Jeder Eintrag enthält unter anderem Benutzer, Gerät, Kunde, Beginn, letzten Kontakt, optionales Ende, Status, Notiz und die verknüpfte Meldung. IDs und Namen können je nach Zuordnung fehlen. Das genaue Antwortschema findest du in der OpenAPI-Oberfläche deiner Instanz unter /openapi/index.html.

totalDurationSeconds ist nur bei gesetztem ticketId eine Zeitsumme. Sie umfasst alle für dich sichtbaren Einträge dieser Meldung, unabhängig von Suche, Zeitraum und Seitennummer. Ohne ticketId ist sie 0. Bei offenen Einträgen zählt die Zeit bis zum letzten Kontakt, nicht bis zur aktuellen Uhrzeit.