Search person detections of the organization associated with the API key.

Only timeRange is required; every other filter is optional. Filters are combined with AND
semantics, values inside an array filter are OR-ed.

Results are sorted by startTime descending (newest first) and paginated with page/size
(zero-based page, size 1..100, default 25).
The response envelope always includes the total number of detections matching the filters, so
total can exceed items.length.

cameraIds and locationIds intersect: a detection must match all provided scope filters.
An empty intersection returns an empty page with total: 0.

Each returned detection carries its trackerId, objectId (PERSON / VEHICLE), the
detection startTime and endTime in milliseconds since epoch, the camera, edge and location
names, the IANA timezone of the camera location, and two image URLs: thumbnailUrl
(GET /v1/search/trackers/{trackerId}/thumbnail, the detection frame) and croppedImageUrl
(GET /v1/search/trackers/{trackerId}/cropped-image, the cropped object). Fetch either with the
same API key — Authorization: Bearer <token> header (preferred) or ?token=<token> query
parameter for <img> embedding (note: query tokens can appear in access logs). Either URL can be
null when the image is unavailable.

Filters:

Attribute values:

When a detection is face-matched to a saved person, the item carries personId, personName
and faceConfidence (1 = none, 3 = low, 5 = medium, 7 = high).

Request examples:

{ "timeRange": { "start": 1752451200000, "end": 1752537600000 } }

{
  "timeRange": { "start": 1752451200000, "end": 1752537600000 },
  "upperBodyColors": ["BLACK"],
  "upperBodyTypes": ["LONG_SLEEVE"],
  "genders": ["MALE"],
  "ageGroups": ["FROM_18_TO_60"],
  "accessories": ["HAT"],
  "page": 0,
  "size": 25
}

{
  "timeRange": { "start": 1752451200000, "end": 1752537600000 },
  "personIds": [12345],
  "cameraIds": ["6a460f4759e6bb0eb32c6778"]
}

{
  "timeRange": { "start": 1752451200000, "end": 1752537600000 },
  "locationIds": ["60c72b2f9b1d8e001c8a4d3f"],
  "carrying": ["BAG"]
}