---
title: "Get Face"
method: GET
path: "/v2/faces/{face_id}"
tags: ["Faces"]
---

# Get Face

`GET /v2/faces/{face_id}`

This endpoint returns a single Face by its unique identifier.

## Path parameters

- `face_id` string, required

## Query parameters

- `verbose` boolean

## Response `200`

- object
  - `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`. On failure, this is `error` and `error_message` is populated.
  - `created_at` string — The date and time the face was created.
  - `updated_at` string — The date and time of when the face was last updated.
  - `error_message` string, nullable — When `status` is `error`, contains details about the training failure; otherwise typically null.
  - `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`).

## Other responses

- `400` — Bad Request
- `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)