> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt
> Use this file to discover all available pages before exploring further.

# Get normal seekpoint events and access control seekpoint events

> Get normal seekpoint events and access control seekpoint events



## OpenAPI

````yaml https://api2.rhombussystems.com/api/openapi/public.json post /api/eventSearch/getEventSeekpoints
openapi: 3.0.1
info:
  contact:
    email: developer@rhombussystems.com
  description: >-
    This API is for use by Rhombus customers and partners.


    ## Authentication


    All requests require two headers:

    - `x-auth-scheme` — The authentication scheme identifier. Use `api-token`
    for standard API key auth, or `partner-api-token` for partner API auth.

    - `x-auth-apikey` — Your Rhombus API key.


    Example:

    ```

    POST /api/camera/getMinimalCameraStateList

    x-auth-scheme: api-token

    x-auth-apikey: YOUR_API_KEY

    Content-Type: application/json

    ```
  title: Rhombus API
  version: '1.0'
servers:
  - description: Production Server
    url: https://api2.rhombussystems.com
security:
  - ApiKeyAuth: []
paths:
  /api/eventSearch/getEventSeekpoints:
    post:
      tags:
        - Event Search Webservice
      summary: Get normal seekpoint events and access control seekpoint events
      description: Get normal seekpoint events and access control seekpoint events
      operationId: getDeprecatedEventSeekpoints
      parameters:
        - description: >-
            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.
          example: api-token
          in: header
          name: x-auth-scheme
          required: true
          schema:
            type: string
            default: api-token
            enum:
              - api-token
              - api
              - partner-api-token
              - partner-api
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Eventsearch_GetEventSeekpointsWSRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Eventsearch_GetEventSeekpointsWSResponse'
          description: OK
      deprecated: true
components:
  schemas:
    Eventsearch_GetEventSeekpointsWSRequest:
      type: object
      description: >-
        Request object for retrieving event seekpoints with various search
        criteria and filtering options.
      properties:
        activitySet:
          type: array
          description: Set of activity types to filter seekpoints by
          items:
            $ref: '#/components/schemas/ActivityEnum'
          nullable: true
          uniqueItems: true
        componentSeekPointsByAccessControlledDoorWSRequest:
          $ref: >-
            #/components/schemas/Component_FindComponentSeekPointsByAccessControlledDoorWSRequest
        componentSeekPointsByAccessControlledDoorsWSRequest:
          $ref: >-
            #/components/schemas/Component_FindComponentSeekPointsByAccessControlledDoorsWSRequest
        componentSeekPointsByOwnerDeviceWSRequest:
          $ref: >-
            #/components/schemas/Component_FindComponentSeekPointsByOwnerDeviceWSRequest
        durationSec:
          type: integer
          format: int32
          description: Duration in seconds for the search window
          example: 3600
          nullable: true
        searchColorAndVehicleByColorWSRequest:
          $ref: >-
            #/components/schemas/Eventsearch_SearchClothingAndVehicleByColorWSRequest
        searchMotionGridWithActivitiesWSRequest:
          $ref: '#/components/schemas/Event_SearchMotionGridWithActivitiesWSRequest'
        seekpointsWSRequest:
          $ref: '#/components/schemas/Common_devices_GetSeekpointsWSRequest'
        startTimeSec:
          type: integer
          format: int64
          description: Start time in seconds for the search window
          example: 1640995200
          nullable: true
        videoFootageWSRequest:
          $ref: '#/components/schemas/Eventsearch_VideoFootageWSRequest'
    Eventsearch_GetEventSeekpointsWSResponse:
      type: object
      description: >-
        Response object containing combined seekpoints from various event
        sources.
      properties:
        combinedSeekpoints:
          type: array
          description: List of combined seekpoints from various event sources
          items:
            $ref: '#/components/schemas/Eventsearch_CombinedSeekPointType'
          nullable: true
        error:
          type: boolean
          nullable: true
        errorMsg:
          type: string
          nullable: true
        warningMsg:
          type: string
          nullable: true
    ActivityEnum:
      type: string
      enum:
        - 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
        - REID_HUMAN
        - INACTIVITY_HUMAN
        - INACTIVITY_CAR
        - ONGUARD_BADGE_AUTHORIZED
        - ONGUARD_BADGE_ANOMALY
        - ONGUARD_NO_ENTRY_MADE
        - ELEMENTS_BADGE_AUTHORIZED
        - ELEMENTS_BADGE_ANOMALY
        - ELEMENTS_NO_ENTRY_MADE
        - NETBOX_BADGE_AUTHORIZED
        - NETBOX_BADGE_ANOMALY
        - NETBOX_NO_ENTRY_MADE
        - THERMAL_TEMPERATURE_ALARM
        - THERMAL_TEMPERATURE_WARNING
        - THERMAL_FIRE_DETECTED
        - THERMAL_SMOKING_DETECTED
        - THERMAL_FIRE_VERIFIED
        - THERMAL_VISUAL_HOTSPOT
        - THERMAL_VISUAL_HEAT_RISE
        - THERMAL_VISUAL_WARM_BODY
        - UNKNOWN
    Component_FindComponentSeekPointsByAccessControlledDoorWSRequest:
      type: object
      description: Component seekpoints search for access controlled door
      properties:
        accessControlledDoorUuid:
          type: string
          format: RUUID
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          nullable: true
        durationSec:
          type: integer
          format: int32
          nullable: true
        startTimeSecEpochExclusive:
          type: integer
          format: int64
          nullable: true
    Component_FindComponentSeekPointsByAccessControlledDoorsWSRequest:
      type: object
      description: Component seekpoints search for access controlled doors
      properties:
        accessControlledDoorUuidList:
          type: array
          items:
            type: string
            format: RUUID
            description: base 64 (url-safe) uuid string
            example: AAAAAAAAAAAAAAAAAAAAAA
            nullable: true
          nullable: true
        durationSec:
          type: integer
          format: int32
          nullable: true
        sortResponse:
          type: boolean
          nullable: true
        startTimeSecEpochExclusive:
          type: integer
          format: int64
          nullable: true
    Component_FindComponentSeekPointsByOwnerDeviceWSRequest:
      type: object
      description: Component seekpoints search for owner device
      properties:
        durationSec:
          type: integer
          format: int32
          nullable: true
        ownerDeviceUuid:
          type: string
          format: RUUID
          description: base 64 (url-safe) uuid string
          example: AAAAAAAAAAAAAAAAAAAAAA
          nullable: true
        startTimeSecEpochExclusive:
          type: integer
          format: int64
          nullable: true
    Eventsearch_SearchClothingAndVehicleByColorWSRequest:
      type: object
      description: >-
        Request object for searching clothing and vehicle events by color with
        time and device filtering.
      properties:
        clothingColorFilter:
          type: array
          description: Set of clothing colors to filter the search by
          items:
            $ref: '#/components/schemas/ColorEnum'
          nullable: true
          uniqueItems: true
        deviceFilter:
          type: array
          description: List of device UUIDs to filter the search by
          items:
            type: string
            format: DeviceFacetUuid
            description: RUUID with optional appended facet information
            example: AAAAAAAAAAAAAAAAAAAAAA.v0
            nullable: true
          nullable: true
        endTimeMs:
          type: integer
          format: int64
          description: End time in milliseconds for the search window
          example: 1641081600000
          nullable: true
        startTimeMs:
          type: integer
          format: int64
          description: Start time in milliseconds for the search window
          example: 1640995200000
          nullable: true
        vehicleColorFilter:
          type: array
          description: Set of vehicle colors to filter the search by
          items:
            $ref: '#/components/schemas/ColorEnum'
          nullable: true
          uniqueItems: true
    Event_SearchMotionGridWithActivitiesWSRequest:
      type: object
      description: Request object for searching motion grid data with activity information.
      properties:
        deviceUuid:
          type: string
          format: DeviceFacetUuid
          description: RUUID with optional appended facet information
          example: AAAAAAAAAAAAAAAAAAAAAA.v0
          nullable: true
        endTimeUtcSecs:
          type: integer
          format: int64
          description: End time as a UNIX timestamp in seconds
          example: 1641081600
          nullable: true
        searchCells:
          type: array
          description: List of motion grid cells to include in the search
          items:
            $ref: '#/components/schemas/Event_FrontendCell'
          nullable: true
        startTimeUtcSecs:
          type: integer
          format: int64
          description: Start time as a UNIX timestamp in seconds
          example: 1640995200
          nullable: true
      required:
        - deviceUuid
        - endTimeUtcSecs
        - searchCells
        - startTimeUtcSecs
    Common_devices_GetSeekpointsWSRequest:
      type: object
      description: General seekpoints search request parameters
      properties:
        deviceUuid:
          type: string
          format: DeviceFacetUuid
          description: RUUID with optional appended facet information
          example: AAAAAAAAAAAAAAAAAAAAAA.v0
          nullable: true
        durationSecs:
          type: integer
          format: int32
          nullable: true
        includeAnyMotion:
          type: boolean
          nullable: true
        startTimeSec:
          type: integer
          format: int64
          nullable: true
    Eventsearch_VideoFootageWSRequest:
      type: object
      description: >-
        Request object for video footage search with camera selection and
        multi-camera options.
      properties:
        cameraUuid:
          type: string
          format: DeviceFacetUuid
          description: RUUID with optional appended facet information
          example: AAAAAAAAAAAAAAAAAAAAAA.v0
          nullable: true
        cameraUuids:
          type: array
          description: List of camera UUIDs to search for video footage
          items:
            type: string
            format: DeviceFacetUuid
            description: RUUID with optional appended facet information
            example: AAAAAAAAAAAAAAAAAAAAAA.v0
            nullable: true
          nullable: true
        duration:
          type: integer
          format: int32
          description: Duration in seconds
          example: 3600
          nullable: true
        includeAnyMotion:
          type: boolean
          description: Whether to include any motion events
          example: true
          nullable: true
        startTime:
          type: integer
          format: int64
          description: Start time in seconds since epoch
          example: 1640995200
          nullable: true
        useMultiCamera:
          type: boolean
          description: Whether to use multi-camera search functionality
          example: true
          nullable: true
    Eventsearch_CombinedSeekPointType:
      type: object
      description: >-
        Combined seekpoint type containing information from various event
        sources including timestamps, activities, and metadata.
      properties:
        activity:
          $ref: '#/components/schemas/ActivityEnum'
        cameraUuid:
          type: string
          format: DeviceFacetUuid
          description: RUUID with optional appended facet information
          example: AAAAAAAAAAAAAAAAAAAAAA.v0
          nullable: true
        cardholderName:
          type: string
          description: Cardholder (badge holder) name for OnGuard integration seekpoints
          example: Jane Doe
          nullable: true
        customActivityColor:
          $ref: '#/components/schemas/FootageSeekPointColorEnum'
        customActivityDescription:
          type: string
          description: Custom description for the activity
          example: A person was detected in the camera view
          nullable: true
        customActivityDisplayName:
          type: string
          description: Custom display name for the activity
          example: Person Detected
          nullable: true
        dwelling:
          type: boolean
          description: Whether the detected person is dwelling/loitering
          nullable: true
        faceName:
          type: string
          description: Name of the face detected in this seekpoint
          example: John Doe
          nullable: true
        licensePlate:
          type: string
          description: License plate detected in this seekpoint
          example: ABC123
          nullable: true
        objectId:
          type: integer
          format: int32
          description: Object ID for tracking purposes
          example: 12345
          nullable: true
        originalEvent:
          type: object
          description: Original event object that generated this seekpoint
          nullable: true
        seekpointEndTimeMs:
          type: integer
          format: int64
          description: End time in milliseconds for the seekpoint duration
          example: 1640995300000
          nullable: true
        seekpointStartTimeMs:
          type: integer
          format: int64
          description: Start time in milliseconds for the seekpoint duration
          example: 1640995200000
          nullable: true
        stableTrackId:
          type: integer
          format: int32
          description: Stable track ID for re-identification across track segments
          example: 42
          nullable: true
        thumbnailUrl:
          type: string
          description: URL to the thumbnail image for this seekpoint
          example: https://example.com/thumbnail.jpg
          nullable: true
        timestampMs:
          type: integer
          format: int64
          description: Timestamp in milliseconds when the seekpoint occurred
          example: 1640995200000
          nullable: true
        unidentifiedFaceId:
          type: string
          description: ID for unidentified faces
          example: face_12345
          nullable: true
    ColorEnum:
      type: string
      description: Set of colors to filter by
      enum:
        - BLACK
        - BLUE
        - BROWN
        - GRAYWHITE
        - GREEN
        - ORANGE
        - PINK
        - PURPLE
        - RED
        - YELLOW
        - UNKNOWN
    Event_FrontendCell:
      type: object
      description: Represents a cell in the motion grid with column and row coordinates.
      properties:
        col:
          type: integer
          format: int32
          description: Column coordinate of the cell
          example: 5
          nullable: true
        row:
          type: integer
          format: int32
          description: Row coordinate of the cell
          example: 3
          nullable: true
    FootageSeekPointColorEnum:
      type: string
      enum:
        - BLUE
        - RED
        - PURPLE
        - TAN
        - ORANGE
        - TEAL
        - GRAY
        - BLACK
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header
        set to `api-token` (or `partner-api-token` for partner endpoints).
      in: header
      name: x-auth-apikey
      type: apiKey

````