---
title: "List scenes"
method: GET
path: "/projects/{id}/scenes"
tags: ["Scenes"]
---

# List scenes

`GET /projects/{id}/scenes`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/projects/{id}/scenes`
- Auth: HTTP bearer

List all scenes in a project with layer summaries.

## Path parameters

- `id` string, required

## Response `200`

List of scenes

- object
  - `scenes` Scene[]
    - `id` string: Unique scene identifier
    - `name` string, nullable: Scene name
    - `isActive` boolean: Whether this scene is currently active
    - `layers` Layer[]: Layers in this scene (includes pinned layers)
      - `id` string: Unique layer identifier
      - `type` string: Layer type (e.g. videoPlaylist, image, text, audioPlaylist, video)
      - `name` string, nullable: Layer name
      - `nextScene` string: Only present when set — ID of scene to auto-switch to when playback finishes. Applies to video, videoPlaylist, and audioPlaylist layers.
      - `pinned` boolean: Only present when true — layer is visible on all scenes

## Other responses

- `401`: Authentication failed
- `404`: Project not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/livereacting/apis/livereacting-api.md) · [All operations](https://skmtc.dev/livereacting/apis/livereacting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livereacting/apis/livereacting-api/revisions/17a9f1677fbf?raw)