---
title: "Get a list of the avatars"
method: GET
path: "/scenes/avatars"
tags: ["Scenes (Express Avatars)"]
---

# Get a list of the avatars

`GET /scenes/avatars`

## Query parameters

- `limit` number, double
- `token` string

## Response `200`

OK

- GetAvatarsResponseDto
  - `avatars` GetAvatarResponseDto[], required
    - `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
  - `token` string

---

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