# Episode timeline

Information about timeline events with complete timing information.

## Retrieve all timeline events for an episode

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


Timeline events represent time-based points or ranges within the content where interactive
elements, metadata, or other content enhancements are available. These events are the
foundation for interactive video experiences and synchronized metadata display.


Timeline events enable precisely timed interactions, product placements, character
information, and other contextual content to appear at appropriate moments during playback.


The timeline events system supports two types of time filtering:


1. Millisecond-based filtering: Using the absolute time in milliseconds from the start

2. Timecode filtering: Using industry-standard SMPTE timecode (hh:mm:ss:ff)


Each event has a kind that indicates what type of content it represents (scene, product,
character, etc.) and contains references or inline data about that content.