Returns unified events from camera, access control, and sensor devices within a specified time range.

This endpoint consolidates events from camera, access control, and sensor devices in your organization, providing a single interface to retrieve security events, access control events, and environmental sensor events.

Default Behavior: Returns events from all supported product types from the last hour if no filters are specified.

Supported Event Types

Camera Events:

• camera_online, camera_offline - Camera connectivity status
• motion - Motion detection events
• person_of_interest - Person of Interest detections
• license_plate_of_interest - License Plate of Interest detections
• tamper - Camera tampering events
• crowd - Crowd detection events
• line_crossing - Line crossing rule violations
• loitering - Loitering/dwell time violations
• inactivity - Inactivity/no-motion alert violations

Access Control Events:

• door_opened, door_granted, door_rejected - Access events
• door_forced_open, door_held_open - Security violations
• door_tailgating - Tailgating detection
• door_tamper - Door tampering events
• door_offline - Access control unit connectivity
• Plus 50+ additional access control event types for comprehensive monitoring

Sensor Events:

• temperature, humidity - Climate monitoring alerts
• tvoc, co2, pm25 - Air quality alerts
• noise - Noise level alerts
• sensor_motion - Motion detection from sensors
• air_quality - General air quality alerts

Filtering

Use these query parameters to filter results:

• product_types: Comma-separated product types (camera, access_control, sensor)
• device_ids: Comma-separated list of device IDs to filter by
• event_types: Comma-separated list of event types (see supported types above)
• start_time: Start time in ISO 8601 format (e.g., 2025-01-17T09:00:00Z)
• end_time: End time in ISO 8601 format (defaults to current time if not specified)
• site_ids: Comma-separated list of site IDs (for access control events)

Pagination

This endpoint uses cursor-based pagination with these parameters:

• limit: Number of events to return (1-1000, default 100)
• cursor: Pagination cursor from previous response for next page
• Continue paginating while the response includes a cursor value

Examples

Get all events from the last hour:

GET /v2/events

Get only camera motion events from a specific time range:

GET /v2/events?product_types=camera&event_types=motion&start_time=2025-01-17T09:00:00Z&end_time=2025-01-17T17:00:00Z

Get access control events for specific doors:

GET /v2/events?product_types=access_control&device_ids=door1,door2&limit=50

Get sensor temperature and humidity alerts:

GET /v2/events?product_types=sensor&event_types=temperature,humidity&start_time=2025-01-17T09:00:00Z