Skip to main content
POST
/
api
/
eventSearch
/
getEventSeekpoints
Get normal seekpoint events and access control seekpoint events
curl --request POST \
  --url https://api2.rhombussystems.com/api/eventSearch/getEventSeekpoints \
  --header 'Content-Type: application/json' \
  --header 'x-auth-apikey: <api-key>' \
  --header 'x-auth-scheme: <x-auth-scheme>' \
  --data '{}'
{
  "combinedSeekpoints": [
    {
      "cameraUuid": "AAAAAAAAAAAAAAAAAAAAAA.v0",
      "customActivityDescription": "A person was detected in the camera view",
      "customActivityDisplayName": "Person Detected",
      "dwelling": true,
      "faceName": "John Doe",
      "licensePlate": "ABC123",
      "objectId": 12345,
      "originalEvent": {},
      "seekpointEndTimeMs": 1640995300000,
      "seekpointStartTimeMs": 1640995200000,
      "stableTrackId": 42,
      "thumbnailUrl": "https://example.com/thumbnail.jpg",
      "timestampMs": 1640995200000,
      "unidentifiedFaceId": "face_12345"
    }
  ],
  "error": true,
  "errorMsg": "<string>",
  "warningMsg": "<string>"
}

Authorizations

​
x-auth-apikey
string
header
required

Your Rhombus API key. Must be accompanied by the x-auth-scheme header set to api-token (or partner-api-token for partner endpoints).

Headers

​
x-auth-scheme
enum<string>
default:api-token
required

Authentication scheme identifier. Use api-token for standard API key authentication, partner-api-token for partner API key authentication. Must be paired with the x-auth-apikey header containing your API key.

Available options:
api-token,
api,
partner-api-token,
partner-api

Body

application/json

Request object for retrieving event seekpoints with various search criteria and filtering options.

​
activitySet
enum<string>[] | null

Set of activity types to filter seekpoints by

Available options:
SOUND_LOUD,
SOUND_GUN_SHOT,
TAMPER,
VISUAL_TAMPER,
MOTION_TAMPER,
MOTION,
MOTION_HUMAN,
MOTION_CAR,
MOTION_ANIMAL,
FACE,
FACE_IDENTIFIED,
FACE_UNIDENTIFIED,
FACE_BLACKLISTED,
FACE_ALERT,
POSE_ANOMALOUS,
POSE_FALL,
LICENSEPLATE,
LICENSEPLATE_IDENTIFIED,
LICENSEPLATE_UNIDENTIFIED,
LICENSEPLATE_ALERT,
LICENSEPLATE_BLACKLISTED,
LICENSEPLATE_TRUSTED,
PEOPLECOUNT_HIGH,
PEOPLECOUNT_HIGH_RESET,
PEOPLECOUNT_LOW,
PEOPLECOUNT_LOW_RESET,
HUMAN_ENTER,
HUMAN_EXIT,
CAR_ENTER,
CAR_EXIT,
TEMPERATURE_EXCEEDED_HIGH,
TEMPERATURE_EXCEEDED_LOW,
HUMIDITY_EXCEEDED_HIGH,
HUMIDITY_EXCEEDED_LOW,
PM25_EXCEEDED_HIGH,
TVOC_EXCEEDED_HIGH,
ETOH_EXCEEDED_HIGH,
IAQ_EXCEEDED_HIGH,
CO2_EXCEEDED_HIGH,
CO2_EXCEEDED_LOW,
PROBE_TEMPERATURE_EXCEEDED_HIGH,
PROBE_TEMPERATURE_EXCEEDED_LOW,
PROBE_DISCONNECTED,
PROBE_CONNECTED,
HEAT_INDEX_EXCEEDED_HIGH,
PRESSURE_EXCEEDED_HIGH,
PRESSURE_EXCEEDED_LOW,
PM10_EXCEEDED_HIGH,
PM40_EXCEEDED_HIGH,
PM100_EXCEEDED_HIGH,
VOC_IDX_EXCEEDED_HIGH,
NOX_IDX_EXCEEDED_HIGH,
FORMALDEHYDE_EXCEEDED_HIGH,
CARBON_MONOXIDE_EXCEEDED_HIGH,
AQI_EXCEEDED_HIGH,
DOOR_AJAR,
DOOR_OPENED,
DOOR_CLOSED,
BUTTON_SINGLE_PRESSED,
BUTTON_DOUBLE_PRESSED,
BUTTON_LONG_PRESSED,
TAG_ARRIVED,
TAG_DEPARTED,
TAG_MOVED,
TAG_POSITIONING_CHANGED,
TAG_BOUNDARY_INGRESS,
TAG_BOUNDARY_EGRESS,
TAG_PANIC,
BADGE_AUTHORIZED,
BADGE_UNAUTHORIZED,
BADGE_UNAUTHORIZED_V2,
BADGE_AJAR,
BADGE_MANUAL,
BADGE_FORCED_OPEN,
BADGE_LOCKDOWN,
BADGE_REQUEST_TO_EXIT,
BADGE_DURESS,
BADGE_SECURITY_BREACH,
BADGE_TAMPER,
BADGE_FACE_MISMATCH,
POS_ORDER,
GUN_DETECT_EVENT,
IOT_SOUND_AGGRESSION,
IOT_SOUND_HELP,
IOT_AIR_CO,
IOT_AIR_CO2,
IOT_AIR_MASKING,
IOT_AIR_THC,
IOT_AIR_VAPE,
IOT_AIR_VOC,
IOT_AIR_TEMP,
IOT_TAMPER,
IOT_GUNSHOT,
IOT_BUTTON_SINGLE_CLICK,
IOT_BUTTON_DOUBLE_CLICK,
IOT_BUTTON_HOLD,
IOT_PANIC_BUTTON_TRIGGERED,
AUDIO_SOUND_SIGNIFICANT,
AUDIO_SOUND_LOUD,
AUDIO_SOUND_ABUSIVE,
AUDIO_SOUND_GREETING,
AUDIO_SOUND_HELP,
AUDIO_SOUND_GUN,
AUDIO_SOUND_GLASS_BREAK,
AUDIO_SOUND_ALARM_SMOKE_FIRE,
AUDIO_SOUND_ALARM_CARBON_MONOXIDE,
AUDIO_SOUND_SIREN,
CLIMATE_VOC,
CLIMATE_VAPE,
CLIMATE_SMOKE,
CLIMATE_THC,
CLIMATE_CO2,
CLIMATE_ETOH,
CLIMATE_PM25,
CLIMATE_IAQ,
CLIMATE_LEAK,
SOUND_AGGRESSION,
SOUND_HELP,
AIR_CO,
AIR_CO2,
AIR_MASKING,
AIR_THC,
AIR_VAPE,
AIR_VOC,
MASK_MISSING,
HELMET_MISSING,
GLOVES_MISSING,
PIR_OCCUPIED,
PIR_MOVEMENT,
PIR_VACANT,
CUSTOM,
VISITOR_ARRIVED,
VISITOR_DEPARTED,
AC_DR_CONNECTED,
AC_DR_DISCONNECTED,
AC_DPI_DOOR_OPEN,
AC_DPI_DOOR_CLOSED,
AC_DPI_DOOR_AJAR,
AC_DPI_DOOR_FORCED_OPEN,
AC_DSR_UNLOCKED,
AC_DSR_LOCKED,
AC_DB_TRIGGERED,
AC_PANIC_BUTTON_TRIGGERED,
AC_REMOTE_UNLOCK,
AC_BADGE_AUTHORIZED,
AC_BADGE_UNAUTHORIZED,
AC_BADGE_FACE_MISMATCH,
AC_LOCKDOWN_ACTIVATED,
AC_LOCKDOWN_DEACTIVATED,
AC_TAMPER_PROX,
AC_TAMPER_ACCEL,
AC_TAMPER_SWITCH,
AC_GR_ACTIVE,
AC_GR_INACTIVE,
AC_GI_ACTIVE,
AC_GI_INACTIVE,
AC_REX_ACTIVE,
AC_REX_INACTIVE,
AC_APERIO_DEVICE_DISCONNECTED,
AC_APERIO_DEVICE_CONNECTED,
AC_APERIO_DEVICE_REBOOT,
AC_APERIO_DEVICE_TAMPER,
AC_APERIO_LOW_BATTERY,
AC_APERIO_FLAT_BATTERY,
AC_APERIO_OK_BATTERY,
POWER_SWITCH_BATTERY,
POWER_SWITCH_PRIMARY,
CUSTOM_LLM_BOOLEAN_TRUE,
CUSTOM_LLM_BOOLEAN_FALSE,
CUSTOM_LLM_THRESHOLD_EXCEEDED_LOW,
CUSTOM_LLM_THRESHOLD_EXCEEDED_HIGH,
ALM_AUTHORITIES_CONTACTED,
ALM_MONITORING_ENABLED,
ALM_MONITORING_DISABLED,
ALM_MONITORING_SETTINGS_CHANGE,
ALM_THREAT_CASE_CLOSED,
ALM_THREAT_DETECTED,
ALM_MONITORING_EVENT_DETECTED,
ROBOT_DOG_DETECTED,
ROBOT_ARRIVED_AT_WAYPOINT,
ROBOT_ARRIVED_AT_POSE,
ROBOT_WAITING_AT_POSE,
ROBOT_MANUAL_CMD_VEL,
ROBOT_MANUAL_ACTION,
ROBOT_MANUAL_POSTURE,
ROBOT_NAVIGATE_TO_POSE_START,
ROBOT_NAVIGATE_TO_POSE_END,
ROBOT_NAVIGATE_TO_HOME_START,
ROBOT_NAVIGATE_TO_HOME_END,
ROBOT_NAVIGATE_TO_WAYPOINT_START,
ROBOT_NAVIGATE_TO_WAYPOINT_END,
ROBOT_ROUTE_RUN_START,
ROBOT_ROUTE_RUN_END,
ROBOT_LOW_BATTERY_DOCKING,
ROBOT_IDLE_DOCKING,
ROBOT_EMERGENCY,
LOITER_HUMAN,
UNKNOWN
​
componentSeekPointsByAccessControlledDoorWSRequest
object

Component seekpoints search for access controlled door

​
componentSeekPointsByAccessControlledDoorsWSRequest
object

Component seekpoints search for access controlled doors

​
componentSeekPointsByOwnerDeviceWSRequest
object

Component seekpoints search for owner device

​
durationSec
integer<int32> | null

Duration in seconds for the search window

Example:

3600

​
searchColorAndVehicleByColorWSRequest
object

Request object for searching clothing and vehicle events by color with time and device filtering.

​
searchMotionGridWithActivitiesWSRequest
object

Request object for searching motion grid data with activity information.

​
seekpointsWSRequest
object

General seekpoints search request parameters

​
startTimeSec
integer<int64> | null

Start time in seconds for the search window

Example:

1640995200

​
videoFootageWSRequest
object

Request object for video footage search with camera selection and multi-camera options.

Response

200 - application/json

OK

Response object containing combined seekpoints from various event sources.

​
combinedSeekpoints
object[] | null

List of combined seekpoints from various event sources

​
error
boolean | null
​
errorMsg
string | null
​
warningMsg
string | null
Last modified on June 6, 2026