10.09.2025 - Event Types Update
Updates to Events and Data Schemas
New Event Types
Animal Detection Event
Generated when there is an animal in motion in front of the camera. The event represents the span of time for which the animal was in motion, and a null endTimestamp indicates that the animal's motion was still ongoing when the event was retrieved.
Crowd Formation Detection Event
Detects the formation of a crowd of people.
Updated Event Types
Device Cloud Status Update Event
These events will now include the previous status of the device in the Device Cloud Previous Status data schema.
New Data Schemas
Animal Attributes
Attributes related to an animal detected in an event image
{
"type": "een.animalAttributes.v1",
"creatorId": "string_example",
"objectId": "camera-46743c2:d3275d08-16df-4176-b9c6-688046c858a2",
"timestamp": "2021-04-22T00:00:00.000+00:00",
"stationary": true,
"stationaryConfidence": 0.75
}Device Cloud Previous Status
Previous cloud connectivity status of a device.
{
"type": "een.deviceCloudPreviousStatus.v1",
"connectionStatus": "deviceOffline",
"startTimestamp": "2025-03-15T14:20:05.419+00:00",
"duration": 120000
}POS Transaction Card Load Summary
Summary data specific to card load operations in PoS Transaction.
{
"type": "een.posTransactionCardLoadSummary.v1",
"creatorId": "string_example",
"accountNumber": "8737",
"approvalTimestamp": "2023-04-01T09:58:26.030+00:00",
"balance": 150.75
}Raw Data
This schema is used to capture raw data of the event before any processing.
{
"type": null,
"creatorId": "string_example",
"rawJson": {}
}User Tags
Tags containing all user information associated with the specific vehicle entry.
{
"type": "een.userTags.v1",
"creatorId": "een.lpr",
"tag": "105A"
}Updated Data Schemas
Alert Condition Rule Info
The maxWaitTimeSeconds field has been added. In cases where human validation is required for an alert (such as in gun detection events), this field indicates the maximum time (in seconds) to wait for human validation before the alert is applied.
Device Cloud Status Update
The list of possible connectionStatus values has been updated. The new values are:
online: The device is online and operational.deviceOffline: The device is offline.bridgeOffline: The bridge that connects to the device itself has no connection with the cloud.off: The device is online, but has been turned off by the user.error: The device is offline due to some problem that has not been described by any of the other statuses.unknown: The device state is unknown for some reason.invalidCredentials: Credentials for this device are not valid.
EEVA Attributes
The reason field has been added to provide additional context on the EEVA event. This field contains an explanation detailing the reasoning or evidence behind the provided answer. This field helps clarify why the answer was determined to be true, or false, and may include relevant observations from the analyzed data.
Object Classification
The animal class has been added to the list of possible class values. This class represents animals detected in the event image.
Person Attributes
Secondary clothing color attributes have been added to the schema. The new fields are:
upperBodyClothingColorSecondaryupperBodyClothingColorSecondaryConfidencelowerBodyClothingColorSecondarylowerBodyClothingColorSecondaryConfidence
POS Transaction Cart Change Trail
The cartChangeOrigin field has been added to the schema. This property indicates the origin of the cart change event. This can be used to identify whether the change was initiated by scanning the item, searching for it, etc.
In addition, the following fields have been added to the item object within the schema:
restrictionCode (string)
Restriction code for the item purchased. This is used to indicate if the item is restricted for sale to certain age groups or other criteria. For example, 'alcohol', 'tobacco', etc.
departmentId (string)
ID of the department which the item belongs to.