---
title: "Fetch event list."
method: GET
path: "/event/fetch"
tags: ["Tracking|Event"]
---

# Fetch event list.

`GET /event/fetch`

This method allows the events to be requested with additional filters. It is important to know that Stamp Events
do not contain a time stamp object used for time tracking. It is only the event of a triggered time recording
module on a vehicle or a triggered time recording terminal. If you want to use time stamp data, consider using
the Employee Stamp endpoint. For timestamp data, it is advised to use the Time Tracking|Employee Stamp endpoint.
If you need to request an employee's work time, it is recommended to use the Time Tracking|Employee time tracking
endpoint. Other events include the ignition, device movement, or stopping tracker.

## Query parameters

- `eventTypes[]` string[]
- `sensorValueTypeName` string
- `trackers[byIds][]` integer[]
- `trackers[byLicenseNumbers][]` string[]
- `trackers[byIdentifiers][]` string[]
- `trackers[byIdentificationNumbers][]` string[]
- `trackers[byImportKeys][]` string[]
- `trackers[importSource]` string
- `trackers[byName]` string
- `trackers[byDriver]` string
- `trackers[byEmployees][byIds][]` integer[]
- `trackers[byEmployees][byReferences][]` string[]
- `trackers[byEmployees][byCardNumbers][]` string[]
- `trackers[byEmployees][byIbuttonNumbers][]` integer[]
- `trackers[byEmployees][byImportKeys][]` string[]
- `trackers[byEmployees][importSource]` string
- `employees[byIds][]` integer[]
- `employees[byReferences][]` string[]
- `employees[byCardNumbers][]` string[]
- `employees[byIbuttonNumbers][]` integer[]
- `employees[byImportKeys][]` string[]
- `employees[importSource]` string
- `offset` integer
- `limit` integer
- `date` string

## Response `200`

Success Response:

- StandardEventFetchResponse
  - `trackers` object[] — The vehicles.
    - `id` integer — The internal vehicle ID.
    - `identifier` string — The customer-specific ID. (max. 64 characters)
    - `inventoryNumber` string — The inventory number. (max. 128 characters)
    - `licenseNumber` string — The vehicle license plate. (max. 255 characters)
    - `identificationNumber` string — The vehicle identification number. (max. 24 characters)
    - `importSource` string — External data source from which this vehicle originates. (max. 64 characters)
    - `importKey` string — External ID from the respective data source. (max. 64 characters)
    - `name` string — The vehicle name. (max. 255 characters)
    - `driverName` string — The driver's name.
    - `events` object[] — The events.
      - `type` string — The event type | Value | Description | |--------------------------|--------------------------------------| | MOVE | Move | | STOP | Stop | | STAMP | Stamp | | IGNITION | Ignition | | SENSOR | Sensor |
      - `sensorValueTypeName` string — The event value type name.
      - `startTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `startLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `startProjectId` integer — The project the vehicle was located at the event start.
      - `endTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `endLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `endProjectId` integer — The project the vehicle was located at the event start.
      - `distance` integer — The driven distance in meters.
      - `employeeId` integer — For MOVE events the driver. For STAMP events the employee.
      - `beaconIds` integer — The beacon's IDs of the event.
    - `costCenter` string — The cost center.
  - `employees` object[] — The referenced employees.
    - `id` integer — The internal employee ID.
    - `reference` string — The personal number. (max. 20 characters)
    - `cardNumber` string — The driver card number.
    - `importSource` string — External data source from which this employee originates. (max. 16 characters)
    - `importKey` string — External ID from the respective data source. (max. 64 characters)
    - `firstName` string — The first name of the employee. (max. 128 characters)
    - `lastName` string — The last name of the Employee. (max. 128 characters)
    - `name` string — This field is deprecated. Please use firstName The complete Name of the Employee If first name or last name is set, name is ignored.
  - `projects` object[] — The referenced projects.
    - `id` integer — The internal project ID.
    - `reference` string — The project number.
    - `importSource` string — External data source from which this project originated.
    - `importKey` string — External ID from the respective data source.
    - `name` string — The project name. (max. 255 characters)
    - `description` string — The project description.
    - `extraName1` string — The name1 address addition. (max. 255 characters)
    - `extraName2` string — The name2 address addition. (max. 255 characters)
    - `extraName3` string — The name3 address addition. (max. 255 characters)
    - `street` string — The street.
    - `zipCode` string — The zip code.
    - `city` string — The city.
    - `countryCode` string — The two-digit ISO 3166 country code.
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `costCenter` string — The cost center. (max. 64 characters)
  - `totalCount` integer — Total number of events. (Only calculated if offset is 0)

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)