How to Retrieve Analytics Events Without Using Legacy /ec2 Endpoints?

Completed

Julien ROMANO

August 09, 2025 19:24

Hi,

We are currently integrating CVEDIA AI detections with Nx Witness and would like to retrieve analytics events (and ideally bounding box/object data) using only the latest REST API v3, without relying on any legacy /ec2/* endpoints.

The goal is:

• On receiving a POST from Nx (triggered by a CVEDIA analytics rule),
• Query the server for the most recent analytics event for a specific camera and zone,
• Retrieve event details (timestamp, type, camera ID),
• Get bounding box information or “best shot” from the event,
• Then use that timestamp to generate a snapshot/clip via v3 endpoints.

Currently, the only way we’ve found to get bounding boxes or tracked objects is via:

/ec2/analyticsLookupObjectTracks

However, this is marked as legacy and may be removed in future releases.

Questions:

1. What is the recommended v3 endpoint (or sequence of calls) to retrieve recent analytics events for a specific camera?
2. Is there a v3-compliant way to get the bounding box and/or “best shot” image for an analytics event?
3. Is there a mapping between the v3 event data and object tracking data that would allow us to replace /ec2/analyticsLookupObjectTracks entirely?

We want to make sure our integration is future-proof and will work in upcoming Nx versions without relying on deprecated endpoints.

Thanks in advance for any guidance or best practices!

0

• 

  Ruslan Zinatullin

  • Network Optix team

  August 15, 2025 15:06

  Hi Julien,

  There are no compatible v3 endpoints because the EC2 endpoints are still available in 6.0 systems. 

  Please check the v4 analytics endpoints introduced in 6.1+ systems. You can use /rest/v4/analytics/objectTracks and /rest/v4/analytics/objectTracks/{id}/bestShotImage for your purposes.

  0

Post is closed for comments.