---
title: "List Faces"
method: GET
path: "/v2/faces"
tags: ["Faces"]
---

# List Faces

`GET /v2/faces`

Returns all faces (photorealistic likenesses trained with Phoenix) created by the account associated with the API key.

**Legacy:** `/v2/replicas` and `replica_id` / `replica_ids` remain supported as aliases.

## Query parameters

- `limit` integer
- `page` integer
- `verbose` boolean
- `face_type` 'user' | 'system'
- `face_ids` string
- `model_name` string

## Response `200`

- object
  - `data` object[] — Faces for the current page; use `total_count` for the full count under the applied filters.
    - `face_id` string — A unique identifier for the face.
    - `face_name` string — The name of the face.
    - `thumbnail_video_url` string — A direct link to the video that will be used as the thumbnail for the face.
    - `training_progress` string — Training progress as a string (for example `100/100`).
    - `status` string — Training lifecycle: `started`, `completed`, or `error`.
    - `created_at` string
    - `face_type` string — If `verbose` query paramter is set to true. The type of face. Possible values: user, system. User faces are faces that have been created by users. System faces are stock Tavus faces that anyone may use
    - `model_name` string — The Phoenix model the face was trained on (e.g. `phoenix-3`, `phoenix-4`).
  - `total_count` integer — The total number of faces given the filters provided.

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)