REST DokumentationTravel DataGET Anfahrtsdaten aller Mitarbeiter auflisten

Anfahrtsdaten aller Mitarbeiter auflisten

Liefert die Anfahrtsdaten-Einträge des gesamten Mandanten mit dem Benutzernamen je Eintrag, sortiert nach Benutzername und valid_from; filterbar nach Mitarbeiter und valid_from. Erfordert das Modul Inovex.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/travel-data
curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/travel-data' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Query-Parameter

  • Name
    limit
    Type
    integer, nullable
    Description

    Die Anzahl der Datensätze pro Seite, 1 bis 200. Standardwert ist 15.

  • Name
    page
    Type
    integer, nullable
    Description

    Die zurückzugebende Ergebnisseite, beginnend bei 1.

  • Name
    username[]
    Type
    Liste von string
    Description

    Nur Einträge dieser Mitarbeiter zurückgeben, angegeben als Benutzernamen; für mehrere Mitarbeiter username[] wiederholen (ein einfach wiederholtes username behält nur den letzten Wert).

  • Name
    valid_from_after
    Type
    string (date), nullable
    Description

    Nur Einträge zurückgeben, die nach diesem Tag gelten (Y-m-d, ausschließlich).

  • Name
    valid_from_before
    Type
    string (date), nullable
    Description

    Nur Einträge zurückgeben, die bis einschließlich zu diesem Tag gelten (Y-m-d, einschließlich).

Response

{
  "data": [
    {
      "id": 1,
      "username": "max.mustermann",
      "valid_from": "2026-01-01",
      "distance": 1.5,
      "travel_time": 1.5
    }
  ]
}

Response-Felder

  • Name
    id
    Type
    integer
    Description

    Eindeutige Kennung des Anfahrtsdaten-Eintrags.

  • Name
    username
    Type
    string
    Description

    Benutzername des Mitarbeiters, zu dem der Eintrag gehört.

  • Name
    valid_from
    Type
    string (date)
    Description

    Erster Kalendertag, ab dem Entfernung und Anfahrtzeit gelten, als Y-m-d.

  • Name
    distance
    Type
    number
    Description

    Entfernung zum Arbeitsort in Kilometern.

  • Name
    travel_time
    Type
    number
    Description

    Anfahrtzeit zum Arbeitsort in Stunden.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.