Streav
Streav

GET /v1/movies

Retrieves a paginated list of movies.

Parameters
NameLocated inDescriptionRequiredType
TitlequeryOptional. Filter movies by title.Nostring
GenreIdqueryOptional. Filter movies by a list of genre IDs.No integer
BundleIdqueryOptional. Filter movies associated with a specific bundle ID.Nointeger
LanguageCodequeryOptional. Filter movies by language. Use ISO 639-1 language codes (e.g., 'en' for English).Nostring
CountryCodequeryOptional. Filter movies by country of origin using ISO 3166-1 alpha-2 country codes (e.g., 'US' for United States).Nostring
SortByqueryOptional. Sort movies by specified field. Use 'title' for ascending or 'title_desc' for descending order by title. Use 'releaseDate' or 'releaseDate_desc' for sorting by release date. Use 'rating' or 'rating_desc' for sorting by rating. Defaults to ascending order by ID if not specified.Nostring
IncludequeryOptional. The related data to include. Possible values are genres and casts.No string
PagequeryPage number to retrieve. Default is 1.Nointeger
PageSizequeryNumber of records per page. Default is 25.Nointeger
Responses
CodeDescription
200Success

GET /v1/movies/{id}

Retrieves a movie by ID.

Parameters
NameLocated inDescriptionRequiredType
idpathThe ID of the movie to retrieve.Yesinteger
includequeryThe related data to include. Possible values are genres and casts.No string
Responses
CodeDescription
200Success
422Validation error if the input parameters are incorrect.