---
title: "List face clusters"
method: GET
path: "/clusters/faces/"
tags: ["clusters"]
---

# List face clusters

`GET /clusters/faces/`

## Query parameters

- `age_gte` integer
- `age_lte` integer
- `beard` string[]
- `camera_groups` integer[]
- `cameras` integer[]
- `card` 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
- `emotions` string[]
- `episodes` integer[]
- `event_date_gt` string, date-time
- `event_date_gte` string, date-time
- `event_date_lt` string, date-time
- `event_date_lte` string, date-time
- `events_count_gte` integer
- `events_count_lte` integer
- `events_quality_gte` number, float
- `events_quality_lte` number, float
- `first_event_date_gt` string, date-time
- `first_event_date_gte` string, date-time
- `first_event_date_lt` string, date-time
- `first_event_date_lte` string, date-time
- `gender` string[]
- `glasses` string[]
- `has_card` boolean
- `id_in` integer[]
- `limit` string
- `liveness` string[]
- `look` string[]
- `looks_like` string
- `matched_lists` integer[]
- `medmask` string[]
- `ordering` string
- `page` string
- `pinned` boolean
- `threshold` number
- `tnt_id_in` integer[]

## Response `200`

- PaginatedFaceClusterList
  - `next_page` string, nullable
  - `prev_page` string, nullable
  - `results` FaceCluster[]
    - `id` integer, required
    - `tnt_id` integer, required — Cluster tnt-id
    - `created_date` string, date-time, required — Cluster creation date
    - `events_count` integer, required — Cluster events count
    - `events_quality` number, float, required — Average cluster events quality
    - `cameras` integer[], required — Cluster's cameras list
    - `camera_groups` integer[], required — Cluster's camera groups list
    - `best_event` integer, required — Best cluster event
    - `best_event_quality` number, float, required — Best cluster event quality
    - `card` integer, required — Related card
    - `match_confidence` number, float, required — Card match confidence
    - `matched_lists` integer[], required — Matched watch lists
    - `pinned` boolean — Whether cluster is pinned or not
    - `looks_like` ClusterLooksLike, required
      - `confidence` number, float, required
      - `matched_object` string, nullable, required
    - `looks_like_confidence` number, float, required
    - `case` integer, required — Related case
    - `gender` string, required — Face cluster gender feature
    - `age` integer, required — Face cluster age feature
    - `glasses` string, required — Face cluster glasses feature
    - `emotions` string, required — Face cluster emotions feature
    - `beard` string, required — Face cluster beard feature
    - `liveness` string, required — Face cluster liveness feature
    - `look` string, required — Face cluster look feature
    - `medmask` string, required — Face cluster medmask feature

---

[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)