---
title: "Get an avatar by id"
method: GET
path: "/scenes/avatars/{id}"
tags: ["Scenes (Express Avatars)"]
---

# Get an avatar by id

`GET /scenes/avatars/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- GetAvatarResponseDto
  - `id` string, required — The ID of the avatar
  - `status` 'draft' | 'created' | 'started' | 'training-started' | 'error' | 'done' | 'rejected' | 'validating', required
  - `object` 'scene_avatar', required — An identifier of this avatar
  - `created_at` string, required — Avatar creation time as iso-8601 string
  - `owner_id` string, required — the organization or user id that owns the avatar
  - `modified_at` string, required — Last modified time as iso-8601 string
  - `error` JsonError
    - `kind` string, required
    - `description` string, required
    - `details` unknown
    - `internal` string
  - `started_at` string — Avatar train start time as iso-8601 string
  - `completed_at` string — Avatar train complete time as iso-8601 string
  - `created_by` string — user id that created the avatar
  - `name` string — The name of the avatar
  - `image_url` string — High resolution image of the avatar
  - `thumbnail_url` string — A low resolution image representing the avatar
  - `talking_preview_url` string — A preview video of the avatar
  - `preview_url` string — A short gif, trimmed from the original avatar in low resolution
  - `webhook` string — A webhook URL for sending the payload. In a case of empty value, the webhook will not be triggered
  - `voice_id` string — The voice id of the avatar
  - `source_url` string — The source video url of the avatar
  - `consent_id` string — The consent id used to create the avatar
  - `face_rect` FaceRect
    - `top` number, double, required
    - `left` number, double, required
    - `bottom` number, double, required
    - `right` number, double, required
  - `creation_notes` CreationNotes
    - `is_clone_voice_failed` boolean
    - `worker_errors` JsonError[]
      - `kind` string, required
      - `description` string, required
      - `details` unknown
      - `internal` string

## Other responses

- `401` — AuthorizationError
- `404` — NotFoundError
- `500` — InternalServerError

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/versions/2f2425e1b6b6/schema)