# Episode scenes

Information about the scenes.

## List all scenes in an episode

 - [GET /playouts/{playoutId}/episodes/{episodeId}/scenes](https://docs.jay-metadata.com/apis/playout/latest/openapi/episode-scenes/listscenes.md): Retrieves all scenes from an episode's timeline with optional time-based filtering.


Scenes are sequential segments of the episode that may contain interactive elements,
products, or other metadata. They provide a time-based structure for the content and
can be used for navigation and interaction points.


Scenes form the narrative structure of the content and help viewers understand the
context for interactive elements that appear during playback.


The scenes can be filtered by a specific timestamp (in milliseconds or timecode format)
to find which scene is active at a particular moment in the playback.


When inline=true is specified, referenced objects within scenes (such as products,
characters, or locations) will be expanded with their full data rather than
just providing references.

## Get scene details

 - [GET /playouts/{playoutId}/episodes/{episodeId}/scenes/{sceneId}](https://docs.jay-metadata.com/apis/playout/latest/openapi/episode-scenes/getscene.md): Get the detailed information about a specific scene in the episode.


This endpoint returns timing information, associated products, characters, and other
relevant metadata for a specific scene. Scenes are fundamental narrative units that
provide context for interactive elements and help organize the viewing experience.


Args:

    request: the complete request.
    playout_id: The playout identifier (aka tenant identifier).
    episode_id: The episode identifier
    scene_id: The data identifier
    inline_level: The number of levels to expand inner object inline.

Returns:

    ResultResponse[PlayoutScene]: Result Response contains the requested scene details.

Raises:

    HTTPException: If the episode, descriptions, timeline, or specific scene are not found (404).