---
title: "List cluster events"
method: GET
path: "/cluster-events/bodies/"
tags: ["cluster-events"]
---

# List cluster events

`GET /cluster-events/bodies/`

Use this method to list body cluster events.

## Query parameters

- `age_group` string[]
- `bag_back` string[]
- `bag_ground` string[]
- `bag_hand` string[]
- `body_gender` string[]
- `bottom_color` string[]
- `camera_groups` integer[]
- `cameras` integer[]
- `case_in` integer[]
- `cluster_in` integer[]
- `created_date_gt` string, date-time
- `created_date_gte` string, date-time
- `created_date_last_n_days` number
- `created_date_lt` string, date-time
- `created_date_lte` string, date-time
- `created_date_nth_full_week` number
- `created_date_nth_work_week` number
- `detailed_upper_clothes` string[]
- `episodes` integer[]
- `has_case` boolean
- `has_matches` boolean
- `headwear` string[]
- `helmet_type` string[]
- `id_in` integer[]
- `limit` string
- `lower_clothes` string[]
- `matched_card` integer
- `matched_card_in` integer[]
- `matched_lists` integer[]
- `ordering` string
- `page` string
- `top_color` string[]
- `upper_clothes` string[]
- `vest_type` string[]

## Response `200`

- PaginatedBodyClusterEventList
  - `next_page` string, nullable
  - `prev_page` string, nullable
  - `results` BodyClusterEvent[]
    - `id` integer, required
    - `attributes` object, required
    - `cluster` integer, required
    - `created_date` string, date-time, required — Cluster event creation date
    - `modified_date` string, date-time, required — Cluster event modification date
    - `processing_iteration` integer
    - `score` number, float, required — Event score; Used during clusterization
    - `bbox` integer[], required — Cluster event face bbox
    - `thumbnail` string, uri, required — Cluster event thumbnail
    - `fullframe` string, uri, required — Cluster event full frame
    - `track_start_date` string, date-time, nullable — Creation date of the first related track
    - `track_end_date` string, date-time, nullable — End date of the las related track
    - `episode_last_event_date` string, date-time, required — End date of the related episode
    - `episode_last_event_bbox` integer[], required — Face bbox of the episode last event
    - `episode_last_event_thumbnail` string, uri, required — Thumbnail of the episode last event
    - `episode_last_event_fullframe` string, uri, required — Full frame of the episode last event
    - `match_confidence` number, float, required — Card match confidence
    - `latitude` number, float, required — Cluster event latitude
    - `longitude` number, float, required — Cluster event longitude
    - `camera` integer, required — Event's camera
    - `video_archive` integer, required — Event's video archive
    - `case` integer, required — Related case
    - `episode` integer, required — Related episode
    - `matched_card` integer, required — Matched card
    - `camera_groups` integer[], required — Cluster event camera groups list
    - `matched_lists` integer[], required — Matched watch lists

---

[API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)