---
title: "List human episodes"
method: GET
path: "/episodes/humans/"
tags: ["episodes"]
---

# List human episodes

`GET /episodes/humans/`

Use this method to list human episodes.

## Query parameters

- `acknowledged` boolean
- `acknowledged_by` integer
- `acknowledged_reaction` string
- `age_group` string[]
- `age_gte` string
- `age_lte` string
- `bag_back` string[]
- `bag_ground` string[]
- `bag_hand` string[]
- `beard` string[]
- `body_gender` string[]
- `bottom_color` string[]
- `camera_groups` integer[]
- `cameras` integer[]
- `case_in` integer[]
- `closed_date_gte` string, date-time
- `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[]
- `emotions` string[]
- `events_count_gte` integer
- `eyes_attrs` string[]
- `fall` string[]
- `gender` string[]
- `glasses` string[]
- `handface_phone_call` string[]
- `handface_phone_use` string[]
- `handface_smoking` string[]
- `handface_taking_pictures` string[]
- `has_body` boolean
- `has_case` boolean
- `has_face` boolean
- `headwear` string[]
- `helmet_type` string[]
- `helmet_type_gte` string
- `helmet_type_score_lte` string
- `id_in` integer[]
- `last_body_event` string
- `last_body_event_date_gte` string, date-time
- `last_face_event` string
- `last_face_event_date_gte` string, date-time
- `latitude_gte` number, float
- `latitude_lte` number, float
- `limit` string
- `liveness` string[]
- `longitude_gte` number, float
- `longitude_lte` number, float
- `look` string[]
- `lower_clothes` string[]
- `matched_card` integer
- `matched_card_in` integer[]
- `matched_lists` integer[]
- `medmask` string[]
- `no_body_match` boolean
- `no_face_match` boolean
- `open` boolean
- `ordering` string
- `page` string
- `top_color` string[]
- `upper_clothes` string[]
- `vest_type` string[]
- `vest_type_score_gte` string
- `vest_type_score_lte` string
- `video_archive` integer[]

## Response `200`

- PaginatedHumanEpisodeList
  - `next_page` string, nullable
  - `prev_page` string, nullable
  - `results` HumanEpisode[]
    - `id` integer, required
    - `created_date` string, date-time, required — Episode creation date based on the creation date of the event
    - `closed_date` string, date-time, required — Episode closing date
    - `open` boolean, required
    - `events_count` integer, required — The number of events in the episode
    - `acknowledged` boolean — `true` if the episode is acknowledged
    - `acknowledged_date` string, date-time, required — Acknowledgment date of the episode
    - `acknowledged_by` integer, required — User that acknowledged episode
    - `acknowledged_reaction` string — Episode acknowledgement reaction
    - `cameras` integer[], required — Camera list of the episode
    - `camera_groups` integer[], required — Episode camera group list
    - `matched_lists` integer[], required — Episode matched lists
    - `video_archive` integer, required — Related video archive id
    - `matched_card` integer, required — Matched card
    - `case` integer, required — Related case
    - `lines` CarEpisodeLines[], required
      - `line_crossing_direction` string, required
      - `event_id` string, required — Event id
      - `line` integer, nullable — Line crossed by `event_id` event
      - `line_name` string, required — Short name, up to 256 characters
      - `backward_line_crossing` boolean — Backward line crossing
    - `latitude` number, float, required — Best event latitude
    - `longitude` number, float, required — Best event longitude
    - `face_features` object, required
    - `last_face_event` object, required
    - `matched_face_event` object, required
    - `best_face_event` object, required
    - `body_features` object, required
    - `last_body_event` object, required
    - `matched_body_event` object, required
    - `best_body_event` object, 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)