---
title: "GET /api/scenes"
method: GET
path: "/api/scenes"
tags: ["Scenes"]
---

# GET /api/scenes

`GET /api/scenes`

## Request

- Base URL: `https://api.wearelearning.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wearelearning.io/api/scenes`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

## Response `200`

OK

- SceneDto[]
  - `id` string, required
  - `guid` string, required
  - `name` string, required
  - `timeOfDay` number, float, required
  - `indoorLighting` ColorDto, required
    - `r` number, float, nullable
    - `g` number, float, nullable
    - `b` number, float, nullable
    - `brightness` number, float, nullable
  - `ambientSound` string, required
  - `ambienceVolume` number, float, required
  - `background` BackgroundDto, required
    - `originalImageUrl` string, required
    - `thumbnailImageUrl` string, nullable
    - `desktopImageUrl` string, nullable
    - `mobileImageUrl` string, nullable
    - `mediaReference` MediaReferenceDto, required
      - `id` string, required
      - `fileName` string, required
      - `extension` string, required
      - `contentType` string, required
      - `url` string, required
      - `publicUrl` string, required
      - `thumbnailUrl` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `metadata` MetadataDto, required
        - `type` 'Image' | 'ImageVersion' | 'Video' | 'Audio' | 'Document', required
        - `size` integer, nullable
      - `folderId` string, uuid, nullable: A valid GUID
    - `margin` MarginDto, required
      - `top` number, float, nullable
      - `right` number, float, nullable
      - `bottom` number, float, nullable
      - `left` number, float, nullable
  - `image` string, required
  - `sceneBackground` string, required
  - `sceneCrop` MarginDto, required
    - `top` number, float, nullable
    - `right` number, float, nullable
    - `bottom` number, float, nullable
    - `left` number, float, nullable
  - `title` string, required
  - `characters` SceneCharacterDto[], required
    - `placeholder` string, required
    - `position` Position2dDto, required
      - `x` number, double, required
      - `y` number, double, required
    - `voice` string, required
  - `characterSpots` integer, required
  - `tags` string[], required
  - `hidden` boolean, nullable
  - `isDeleted` boolean, nullable
  - `locked` boolean, nullable
  - `global` boolean, nullable

---

[API](https://skmtc.dev/wearelearning/apis/we-are-learning-api.md) - [All operations](https://skmtc.dev/wearelearning/apis/we-are-learning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wearelearning/apis/we-are-learning-api/revisions/e2ca5265db77?raw)
