GET /video-detections/file/{id}

curl --request GET \
  --url https://api.indoralabs.com/video-detections/file/{id} \
  --header 'x-api-key: <api-key>'

{
  "detections": [
    {
      "id": "c85a3d71-fec9-44b7-9f25-930da5f04c27",
      "tenant_id": "743db90f-7e76-49f7-8d4e-5f42a16efc06",
      "file_id": "de13d372-a870-4eea-b975-9060d442f38c",
      "case_id": null,
      "doc_id": "session-xyz",
      "detections": [],
      "created_at": "2025-09-07T13:48:43.927-05:00"
    },
    {
      "id": "37c1c024-2ecf-4926-b1b3-1e4ed445f3b2",
      "tenant_id": "743db90f-7e76-49f7-8d4e-5f42a16efc06",
      "file_id": "de13d372-a870-4eea-b975-9060d442f38c",
      "case_id": null,
      "doc_id": "session-xyz",
      "detections": [
        {
          "frame": 123,
          "ts": 4.1,
          "label": "Face",
          "confidence": 0.94,
          "bbox": {
            "x": 512,
            "y": 208,
            "w": 128,
            "h": 128
          }
        }
      ],
      "created_at": "2025-10-13T03:12:00.000-05:00"
    }
  ]
}

Video Detections

Get Video Detections

Retrieve all video detection runs associated with a specific file. Each detection run corresponds to one processing job executed against that file (for example, a video redaction pass that looked for faces or license plates). This endpoint returns the raw detection run records exactly as stored, including the per-run detections array (which may be empty [] until a worker populates results) and the creation timestamp. Use this endpoint to: (1) list historical detection/redaction attempts for a file; (2) render overlays from the saved detections array; (3) debug or audit processing for a single file.

Notes:

This route returns all runs for the file (no server-side pagination in the current implementation).
Field names mirror the database table: id, tenant_id, file_id, case_id, doc_id, detections, created_at.
case_id can be null when a detection run is not linked to a case.
detections is a JSON array (serialized), typically an array of objects describing entities per time/frame. Its shape is application-defined and may evolve without breaking this contract.

GET

video-detections

file

{id}

GET /video-detections/file/{id}

curl --request GET \
  --url https://api.indoralabs.com/video-detections/file/{id} \
  --header 'x-api-key: <api-key>'

{
  "detections": [
    {
      "id": "c85a3d71-fec9-44b7-9f25-930da5f04c27",
      "tenant_id": "743db90f-7e76-49f7-8d4e-5f42a16efc06",
      "file_id": "de13d372-a870-4eea-b975-9060d442f38c",
      "case_id": null,
      "doc_id": "session-xyz",
      "detections": [],
      "created_at": "2025-09-07T13:48:43.927-05:00"
    },
    {
      "id": "37c1c024-2ecf-4926-b1b3-1e4ed445f3b2",
      "tenant_id": "743db90f-7e76-49f7-8d4e-5f42a16efc06",
      "file_id": "de13d372-a870-4eea-b975-9060d442f38c",
      "case_id": null,
      "doc_id": "session-xyz",
      "detections": [
        {
          "frame": 123,
          "ts": 4.1,
          "label": "Face",
          "confidence": 0.94,
          "bbox": {
            "x": 512,
            "y": 208,
            "w": 128,
            "h": 128
          }
        }
      ],
      "created_at": "2025-10-13T03:12:00.000-05:00"
    }
  ]
}

Authorizations

x-api-key

string

header

required

Path Parameters

string<uuid>

required

The unique File ID whose detection runs you want to list.

Response

Successfully retrieved all detection runs tied to the specified file. The response includes the raw detection run records as stored in the system.

detections

object[]

required

Array of detection run records for the provided file.

Show child attributes

Delete Video Detection