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

# Get a list of the scenes

`GET /scenes`

## Query parameters

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

## Response `200`

OK

- GetScenesResponseDto
  - `scenes` GetSceneResponseDto[], required
    - `owner_id` string, required — the organization or user id that owns the scene
    - `id` string, required
    - `created_at` string, required
    - `modified_at` string, required — Last modified time as iso-8601 string
    - `created_by` string, required — Unique identifier of the user that submitted the scene
    - `avatar_id` string, required
    - `status` 'created' | 'started' | 'error' | 'done' | 'rejected', required
    - `audio_url` string
    - `result_url` string — The result url of the scene
    - `pending_url` string — The result url in which scene will be saved when done. Returns only when scene is in process.
    - `started_at` string — Video processing start time as iso-8601 string
    - `completed_at` string — Video completion time as iso-8601 string
    - `config` SceneConfig
      - `logo` Logo
        - `url` string, required — https url to an ARGB jpg/png image, a default logo is used otherwise
        - `position` integer[], required — position of the logo in pixels from the top left corner (w,h) negative values are subtracted from last pixel
    - `subtitles_url` string, required — URL for the scene subtitles.
    - `thumbnail_url` string, required — URL for the scene thumbnail.
    - `name` string — The name of the scene
    - `error` JsonError, required
      - `kind` string, required
      - `description` string, required
      - `details` unknown
      - `internal` string
    - `webhook` string, required
    - `user_data` string, required
  - `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)