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

# List face events

`GET /events/faces/`

Use this method to list face events.

## Query parameters

- `acknowledged` boolean
- `age_gte` number
- `age_lte` number
- `backward_line_crossing` boolean
- `beard` string[]
- `beard_score_gte` number
- `beard_score_lte` number
- `bs_type` 'overall' | 'realtime'
- `camera_groups` integer[]
- `cameras` integer[]
- `case_in` integer[]
- `created_date_gte` string, date-time
- `created_date_last_n_days` number
- `created_date_lte` string, date-time
- `created_date_nth_full_week` number
- `created_date_nth_work_week` number
- `emotions` string[]
- `emotions_score_gte` number
- `emotions_score_lte` number
- `episode` integer
- `external_detector` boolean
- `eyes_attrs` string[]
- `eyes_attrs_score_gte` number
- `eyes_attrs_score_lte` number
- `gender` string[]
- `gender_score_gte` number
- `gender_score_lte` number
- `glasses` string[]
- `glasses_score_gte` number
- `glasses_score_lte` number
- `has_case` boolean
- `headpose_pitch_angle_gte` number
- `headpose_pitch_angle_lte` number
- `headpose_yaw_angle_gte` number
- `headpose_yaw_angle_lte` number
- `id` number
- `id_gte` number
- `id_in` string[]
- `id_lte` number
- `latitude_gte` number
- `latitude_lte` number
- `limit` integer
- `line` integer[]
- `line_crossing_direction` string[]
- `liveness` string[]
- `liveness_score_gte` number
- `liveness_score_lte` number
- `longitude_gte` number
- `longitude_lte` number
- `look` string[]
- `look_score_gte` number
- `look_score_lte` number
- `looks_like` string
- `matched_card` integer
- `matched_card_in` integer[]
- `matched_lists` integer[]
- `medmask` string[]
- `medmask_score_gte` number
- `medmask_score_lte` number
- `no_match` boolean
- `ordering` string
- `page` string
- `temperature_gte` number
- `temperature_lte` number
- `threshold` number
- `video_archive` integer[]

## Response `200`

- PaginatedExtendedFaceEventList
  - `next_page` string, uri, nullable
  - `count` integer
  - `results` ExtendedFaceEvent[]
    - `id` string, required
    - `created_date` string, date-time, required
    - `bs_type` 'realtime' | 'overall', required
    - `camera` integer, required — Related `Camera` id
    - `camera_group` integer, required — Related `CameraGroup` id
    - `case` integer, required — Related `Case` id
    - `thumbnail` string, uri, required
    - `fullframe` string, uri, required
    - `matched_card` integer, nullable, required
    - `verbose_matched_card` object, nullable, required
    - `matched_cluster` integer, nullable, required
    - `matched_object` string, required
    - `matched_lists` integer[], required
    - `episode` integer, nullable, required
    - `video_archive` integer, nullable, required
    - `acknowledged` boolean
    - `acknowledged_date` string, date-time, required
    - `acknowledged_by` integer, nullable, required
    - `acknowledged_reaction` string
    - `frame_coords_left` integer, required
    - `frame_coords_top` integer, required
    - `frame_coords_right` integer, required
    - `frame_coords_bottom` integer, required
    - `matched` boolean, required
    - `detector_params` object, required
    - `looks_like_confidence` number, float, nullable, required
    - `confidence` number, float, required
    - `cluster_confidence` number, float, required
    - `quality` number, float, required
    - `features` object, required
    - `external_detector` boolean, required
    - `line` integer, nullable, required
    - `line_crossing_direction` string, nullable, required
    - `backward_line_crossing` boolean, required
    - `meta` object, required
    - `latitude` number, float, nullable, required
    - `longitude` number, float, nullable, required
    - `temperature` number, float, nullable, required

---

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