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

# List user-faces

`GET /user-face/`

This method allows to get list of user-face objects.
 **User-face** is an object that contains source photo, thumbnail, etc

## Query parameters

- `active` boolean
- `id_in` string[]
- `limit` integer
- `ordering` string
- `page` string
- `user` integer[]

## Response `200`

- PaginatedUserFaceUpdateList
  - `next_page` string, uri, nullable
  - `count` integer
  - `results` UserFaceUpdate[]
    - `id` string, required
    - `created_date` string, date-time, required — Object creation date
    - `modified_date` string, date-time, required — Object modification date
    - `source_photo_name` string, required — Filename supplied for `source_photo` on object creation
    - `frame_coords_left` integer — Left border of object's bounding box
    - `frame_coords_top` integer — Top border of object's bounding box
    - `frame_coords_right` integer — Right border of object's bounding box
    - `frame_coords_bottom` integer — Bottom border of object's bounding box
    - `thumbnail` string, uri, required — Object thumbnail
    - `features` object, required
    - `user` integer, required — Related `User` ID

---

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