# Open Media Streaming Specification Documentation

## Docs

- [OMSS v1.1 Explanation](https://omss.mintlify.app/spec/v1.1/explanation/index.md): Our thoughts while designing the Open Media Streaming Standard (OMSS) v1.1 HTTP API. To view the complete specification, see the [Reference](ref).
- [Health check / Home endpoint](https://omss.mintlify.app/spec/v1.1/ref/home/root-omss-backend-information.md): Returns basic information about the backend and available endpoints.
- [API version endpoint](https://omss.mintlify.app/spec/v1.1/ref/home/versioned-root-omss-backend-information.md): Returns version information and available endpoints.
- [Introduction to OMSS v1.1](https://omss.mintlify.app/spec/v1.1/ref/introduction.md): Reference for the Open Media Streaming Standard (OMSS) v1.1 HTTP API. The following pages are generated directly from the OpenAPI specification and defines every endpoint required by an OMSS-compliant server.
- [Get streaming sources for a movie](https://omss.mintlify.app/spec/v1.1/ref/movies/movie-sources.md): Retrieve all available streaming sources and subtitles for a movie by TMDB ID.
- [Refresh cached response](https://omss.mintlify.app/spec/v1.1/ref/refresh/refresh-cached-response.md): Unified endpoint to refresh a response by its identifier, invalidating the cached entry so that the next media request triggers a fresh scrape.
- [Get streaming sources for a TV episode](https://omss.mintlify.app/spec/v1.1/ref/tv/tv-episode-sources.md): Retrieve all available streaming sources and subtitles for a TV episode by TMDB series ID,  season number, and episode number.
- [OMSS v1.1 Specification](https://omss.mintlify.app/spec/v1.1/ref/v1.1-spec.md): Here you can find the complete specification for the Open Media Streaming Standard (OMSS) v1.1 HTTP API. This file can also be found [here](https://github.com/omss-spec/omss-spec/blob/main/spec/v1.1/omss-v1.1.md).

## OpenAPI Specs

- [omss-v1.0](https://raw.githubusercontent.com/omss-spec/omss-spec/refs/heads/main/spec/v1.0/omss-v1.0.yml)
- [omss-v1.1](https://raw.githubusercontent.com/omss-spec/omss-spec/refs/heads/main/spec/v1.1/omss-v1.1.yml)