# Fetch a list of Events within the time period for the Devices or Groups

At least one _deviceId_ or one _groupId_ must be passed

Endpoint: GET /reports/events
Version: 6.10.0
Security: BasicAuth, ApiKey

## Query parameters:

  - `deviceId` (array)

  - `groupId` (array)

  - `type` (array)
    % can be used to return events of all types

  - `from` (string, required)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `to` (string, required)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

## Response 200 fields (application/json):

  - `id` (integer)

  - `type` (string)

  - `eventTime` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `deviceId` (integer)

  - `positionId` (integer)

  - `geofenceId` (integer)

  - `maintenanceId` (integer)

  - `attributes` (object)