Equipment tampering detection API

Check camera images for people opening or handling secured equipment.

What it detects

Monitor utility boxes, secured cabinets and fire equipment for someone opening, prying or handling them.

Detection
A person opening, prying or handling a secured cabinet, utility box, electrical panel, fire equipment or cell-tower equipment. Work clothes or PPE do not change the answer.
Outside the definition
Nobody touching secured equipment.

Send a camera image.

Set KIRKWOOD_API_KEY on your server. Save a frame as frame.jpg.

Python POST /v1/analyze
import base64
import json
import os
import urllib.request

with open("frame.jpg", "rb") as frame:
    image = base64.b64encode(frame.read()).decode()

body = json.loads('''{
  "images": [
    "<BASE64_JPEG>"
  ],
  "tags": [
    "tampering_with_equipment"
  ],
  "detections": {
    "return_boxes": true
  }
}''')
body["images"] = [image]
request = urllib.request.Request(
    "https://app.kirkwood.ai/v1/analyze",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["KIRKWOOD_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
    print(json.dumps(json.load(response), indent=2))

Read the result

The tampering_with_equipment tag returns an answer and probability. Send the source image to your operator with the equipment location.

Camera setup

Keep the equipment and the person’s hands in view. Compare people passing by with people actually touching the cabinet or panel.

Try it on your footage.

Run this tag through the API using the Python example, or request a live demo to try it with us.

Approved account required. Analysis uses credit. Images are retained for annotation and training.

Request a live demo

API pricing

Billed per image analyzed. Contact us for your rate.

Request pricing

Before you integrate

Work clothes and PPE do not change this tag’s answer. It reports the physical action, not whether the work is authorized.

Will authorized maintenance trigger this tag?

It can. The definition includes a person opening or handling secured equipment regardless of clothing. Your workflow decides whether the activity is expected.

API guide