# API documentation ## Docs - [Error Handling](https://sirjosh.mintlify.app/Error-code.md): This page contain common status codes, their meanings, and resolutions - [Glossary](https://sirjosh.mintlify.app/Glossary.md): This page defines technical terms, acronyms, and concepts used throughout the documentation to help users understand the API better. - [Versioning and Changelog](https://sirjosh.mintlify.app/Versioning.md): This page documents changes to the API, explains versioning, and provides guidance on accessing older versions. - [accountid](https://sirjosh.mintlify.app/api-reference/account/accountid.md): This endpoint is used to get the user account_id - [Add Favourite](https://sirjosh.mintlify.app/api-reference/account/add-favourite.md): This endpoint mark a movie or TV show as a favourite. - [Add To Watchlist](https://sirjosh.mintlify.app/api-reference/account/add-to-watchlist.md): This endpoint Add a movie or TV show to your watchlist. - [Details](https://sirjosh.mintlify.app/api-reference/account/details.md): This endpoint get the public details of an account on TMDB. - [Favourite movies](https://sirjosh.mintlify.app/api-reference/account/favourite-movies.md): This endpoint get a users list of favourite movies. - [Favourite TV](https://sirjosh.mintlify.app/api-reference/account/favourite-tv.md): This endpoint get a users list of favourite TV shows. - [Lists](https://sirjosh.mintlify.app/api-reference/account/lists.md): This endpoint get a users list of custom lists. - [Rated movies](https://sirjosh.mintlify.app/api-reference/account/rated-movies.md): This endpoint get a users list of rated movies. - [Rated TV](https://sirjosh.mintlify.app/api-reference/account/rated-tv.md): This endpoint get a users list of rated TV shows. - [Rated TV Episodes](https://sirjosh.mintlify.app/api-reference/account/rated-tv-episodes.md): This endpoint get a users list of rated TV episodes. - [Watchlist Movies](https://sirjosh.mintlify.app/api-reference/account/watchlist-movies.md): This endpoint get a list of movies added to a users watchlist. - [Watchlist TV](https://sirjosh.mintlify.app/api-reference/account/watchlist-tv.md): This endpoint get a list of TV shows added to a users watchlist. - [Create guest session](https://sirjosh.mintlify.app/api-reference/authentication/create-guest-session.md): This endpoint create a user guest session. - [Create request token](https://sirjosh.mintlify.app/api-reference/authentication/create-request-token.md): This endpoint create a request token. - [Create session](https://sirjosh.mintlify.app/api-reference/authentication/create-session.md): This endpoint create the session id. - [Create Session (with login)](https://sirjosh.mintlify.app/api-reference/authentication/create-session-with-login.md): This endpoint create the session id with its login details. - [Validate Key](https://sirjosh.mintlify.app/api-reference/authentication/validate-key.md): This endpoint test your API Key to see if it's valid. - [Movie Certifications](https://sirjosh.mintlify.app/api-reference/certifications/movie-certifications.md): This endpoint get an up to date list of the officially supported movie certifications on TMDB. - [TV Certifications](https://sirjosh.mintlify.app/api-reference/certifications/tv-certifications.md): This endpoint Get an up to date list of the officially supported TV show certifications on TMDB. - [Movie List](https://sirjosh.mintlify.app/api-reference/changes/movie-list.md): This endpoint get a list of all of the movie ids that have been changed in the past 24 hours. - [People List](https://sirjosh.mintlify.app/api-reference/changes/people-list.md): This endpoint allows users to retrieve information regarding people involved in the industry, such as actors, directors, and crew members. - [TV List](https://sirjosh.mintlify.app/api-reference/changes/tv-list.md): This endpoint allows users to retrieve a list of changes that have occurred for TV shows over a specified period. - [Collection_id](https://sirjosh.mintlify.app/api-reference/collections/collection_id.md): This endpoint is used to get the collection_id. - [Details](https://sirjosh.mintlify.app/api-reference/collections/details.md): This endpoint get movie collection details by ID. - [Images](https://sirjosh.mintlify.app/api-reference/collections/images.md): This endpoint get the images that belong to a collection. - [Translations](https://sirjosh.mintlify.app/api-reference/collections/translations.md): This endpoint retrieves the language translations for a specified collection of movies. - [Alternative Names](https://sirjosh.mintlify.app/api-reference/company/alternative-names.md): This endpoint retrieves a list of alternative names associated with a specific company. - [Company_id](https://sirjosh.mintlify.app/api-reference/company/company_id.md): This endpoint is used to get the Company_id - [Details](https://sirjosh.mintlify.app/api-reference/company/details.md): This endpoint get the company details by ID. - [Images](https://sirjosh.mintlify.app/api-reference/company/images.md): This endpoint get the company logos by id. - [Countries](https://sirjosh.mintlify.app/api-reference/configuration/countries.md): This endpoint get the list of countries (ISO 3166-1 tags) used throughout TMDB. - [Details](https://sirjosh.mintlify.app/api-reference/configuration/details.md): This endpoint query the API configuration details. - [Jobs](https://sirjosh.mintlify.app/api-reference/configuration/jobs.md): This endpoint get the list of the jobs and departments we use on TMDB. - [Languages](https://sirjosh.mintlify.app/api-reference/configuration/languages.md): This endpoint get the list of languages (ISO 639-1 tags) used throughout TMDB. - [Primary Translations](https://sirjosh.mintlify.app/api-reference/configuration/primary-translations.md): This endpoint get a list of the officially supported translations on TMDB. - [Timezones](https://sirjosh.mintlify.app/api-reference/configuration/timezones.md): This endpoint get the list of timezones used throughout TMDB. - [Credit_id](https://sirjosh.mintlify.app/api-reference/credit/credit_id.md): This is used to get the credit_id - [Details](https://sirjosh.mintlify.app/api-reference/credit/details.md): This endpoint is used get a movie or TV credit details by ID. - [Movie_id](https://sirjosh.mintlify.app/api-reference/credit/movie_id.md): This endpoint is used to get a movie_id - [Movie](https://sirjosh.mintlify.app/api-reference/discover/movie.md): This endpoint find movies using over 30 filters and sort options. - [TV](https://sirjosh.mintlify.app/api-reference/discover/tv.md): This endpoint find TV shows using over 30 filters and sort options. - [Find By ID](https://sirjosh.mintlify.app/api-reference/find/find-by-id.md): This endpoint find data by external ID's. - [movie List](https://sirjosh.mintlify.app/api-reference/genres/movie-list.md): This endpoint get the list of official genres for movies. - [TV List](https://sirjosh.mintlify.app/api-reference/genres/tv-list.md): This endpoint get the list of official genres for TV shows. - [Rated Movies](https://sirjosh.mintlify.app/api-reference/guest-sessions/rated-movies.md): This endpoint get the rated movies for a guest session. - [Rated TV](https://sirjosh.mintlify.app/api-reference/guest-sessions/rated-tv.md): This endpoint get the rated TV shows for a guest session. - [Rated TV Episodes](https://sirjosh.mintlify.app/api-reference/guest-sessions/rated-tv-episodes.md): This endpoint get the rated TV episodes for a guest session. - [Details](https://sirjosh.mintlify.app/api-reference/keywords/details.md): This endpoint allows users to retrieve detailed information about a specific keyword in The Movie Database. - [Keyword](https://sirjosh.mintlify.app/api-reference/keywords/keyword.md): This endpoint is used to get a keyword_id. - [Movies](https://sirjosh.mintlify.app/api-reference/keywords/movies.md): This endpoint fetch movies associated with a certain keyword. - [Add Movie](https://sirjosh.mintlify.app/api-reference/lists/add-movie.md): This endpoint add a movie to a list. - [Check Item Status](https://sirjosh.mintlify.app/api-reference/lists/check-item-status.md): This endpoint check if an item has already been added to the list. - [Clear List](https://sirjosh.mintlify.app/api-reference/lists/clear-list.md): This endpoint clear all items from a list. - [Create List_id](https://sirjosh.mintlify.app/api-reference/lists/create-list_id.md): This is endpoint is used to create a list. - [Details](https://sirjosh.mintlify.app/api-reference/lists/details.md): This endpoint allows user to access informations addded in the list. - [Remove Movie](https://sirjosh.mintlify.app/api-reference/lists/remove-movie.md): This endpoint remove a movie from a list. - [Now Playing](https://sirjosh.mintlify.app/api-reference/movie-lists/now-playing.md): This endpoint get a list of movies that are currently in theatres. - [Popular](https://sirjosh.mintlify.app/api-reference/movie-lists/popular.md): This endpoint get a list of movies ordered by popularity. - [Top Rated](https://sirjosh.mintlify.app/api-reference/movie-lists/top-rated.md): This endpoint get a list of movies ordered by rating. - [Upcoming](https://sirjosh.mintlify.app/api-reference/movie-lists/upcoming.md): This endpoint get a list of movies that are being released soon. - [Account States](https://sirjosh.mintlify.app/api-reference/movies/account-states.md): This endpoint get the rating, watchlist and favourite status of an account. - [Add Rating](https://sirjosh.mintlify.app/api-reference/movies/add-rating.md): This endpoint rate a movie and save it to your rated list. - [Alternative Titles](https://sirjosh.mintlify.app/api-reference/movies/alternative-titles.md): This endpoint get the alternative titles for a movie. - [Changes](https://sirjosh.mintlify.app/api-reference/movies/changes.md): This endpoint get the recent changes for a movie. - [Details](https://sirjosh.mintlify.app/api-reference/movies/details.md): Get the top level details of a movie by ID. - [External IDs](https://sirjosh.mintlify.app/api-reference/movies/external-ids.md): This endpoint retrieves external identifiers for a specified movie. - [Images](https://sirjosh.mintlify.app/api-reference/movies/images.md): This endpoint get the images that belong to a movie. - [Keywords](https://sirjosh.mintlify.app/api-reference/movies/keywords.md): This endpoint fetches a list of keywords associated with a specified movie - [Latest](https://sirjosh.mintlify.app/api-reference/movies/latest.md): This endpoint get the newest movie ID. - [Lists](https://sirjosh.mintlify.app/api-reference/movies/lists.md): This endpoint get the lists that a movie has been added to. - [Recommendations](https://sirjosh.mintlify.app/api-reference/movies/recommendations.md): This endpoint is used to fetch a list of movie recommendations based on a specified movie. - [Release Dates](https://sirjosh.mintlify.app/api-reference/movies/release-dates.md): This endpoint get the release dates and certifications for a movie. - [Similar](https://sirjosh.mintlify.app/api-reference/movies/similar.md): This endpoint get the similar movies based on genres and keywords. - [Translations](https://sirjosh.mintlify.app/api-reference/movies/translations.md): This endpoint get the translations for a movie. - [Videos](https://sirjosh.mintlify.app/api-reference/movies/videos.md): This endpoint retrieves video information related to a particular movie. - [Watch Providers](https://sirjosh.mintlify.app/api-reference/movies/watch-providers.md): This endpoint get the list of streaming providers we have for a movie. - [Alternative networks](https://sirjosh.mintlify.app/api-reference/networks/alternative-networks.md): This endpoint get the alternative names of a network. - [Details](https://sirjosh.mintlify.app/api-reference/networks/details.md): This endpoint allows you to access detailed data about a specific network identified by its unique ```network_id```. - [Images](https://sirjosh.mintlify.app/api-reference/networks/images.md): This endpoint get the TV network logos by id. - [popular](https://sirjosh.mintlify.app/api-reference/people-list/popular.md): This endpoint get a list of people ordered by popularity. - [Changes](https://sirjosh.mintlify.app/api-reference/people/changes.md): This endpoint get the recent changes for a person. - [Combined Credits](https://sirjosh.mintlify.app/api-reference/people/combined-credits.md): This endpoint get the combined movie and TV credits that belong to a person. - [Details](https://sirjosh.mintlify.app/api-reference/people/details.md): This endpoint query the top level details of a person. - [External IDs](https://sirjosh.mintlify.app/api-reference/people/external-ids.md): This endpoint get the external ID's that belong to a person. - [Images](https://sirjosh.mintlify.app/api-reference/people/images.md): This endpoint get the profile images that belong to a person. - [Latest](https://sirjosh.mintlify.app/api-reference/people/latest.md): This endpoint get the newest created person. This is a live response and will continuously change. - [Movie Credits](https://sirjosh.mintlify.app/api-reference/people/movie-credits.md): This endpoint get the movie credits for a person. - [person_id](https://sirjosh.mintlify.app/api-reference/people/person_id.md): This endpoint is used to search for people (such as actors, actresses, directors, etc.). - [Tagged Images](https://sirjosh.mintlify.app/api-reference/people/tagged-images.md): This endpoint get the tagged images for a person. - [Translations](https://sirjosh.mintlify.app/api-reference/people/translations.md): This endpoint get the translations that belong to a person. - [TV Credits](https://sirjosh.mintlify.app/api-reference/people/tv-credits.md): This endpoint get the TV credits that belong to a person. - [Details](https://sirjosh.mintlify.app/api-reference/reviews/details.md): This endpoint retrieve the details of a movie or TV show review. - [Reviews](https://sirjosh.mintlify.app/api-reference/reviews/reviews.md): Get the user reviews for a movie. - [Multi](https://sirjosh.mintlify.app/api-reference/search/multi.md): This endpoint search for movies, TV shows and people in a single request. - [TV shows](https://sirjosh.mintlify.app/api-reference/search/tv-shows.md): This endpoint search for TV shows by their original, translated and also known as names. - [All](https://sirjosh.mintlify.app/api-reference/trending/all.md): This endpoint get the trending movies, TV shows and people. - [Movies](https://sirjosh.mintlify.app/api-reference/trending/movies.md): This endpoint get the trending movies on TMDB. - [People](https://sirjosh.mintlify.app/api-reference/trending/people.md): This endpoint get the trending people on TMDB. - [TV](https://sirjosh.mintlify.app/api-reference/trending/tv.md): This endpoint get the trending TV shows on TMDB. - [Details](https://sirjosh.mintlify.app/api-reference/tv-episode-group/details.md): This endpoint get the details of a TV episode group. - [Episode Id](https://sirjosh.mintlify.app/api-reference/tv-episode-group/episode-id.md): This endpoint get the episode group id - [Account States](https://sirjosh.mintlify.app/api-reference/tv-episodes/account-states.md): This endpoint get the rating, watchlist and favourite status. - [Add Rating](https://sirjosh.mintlify.app/api-reference/tv-episodes/add-rating.md): This endpoint rate a TV episode and save it to your rated list. - [Changes](https://sirjosh.mintlify.app/api-reference/tv-episodes/changes.md): This endpoint get the recent changes for a TV episode. - [Credits](https://sirjosh.mintlify.app/api-reference/tv-episodes/credits.md): This endpoint retrieves the cast and crew details for a specific season of a TV episodes. - [Delete Rating](https://sirjosh.mintlify.app/api-reference/tv-episodes/delete-rating.md): This endpoint delete your rating on a TV episode. - [External IDs](https://sirjosh.mintlify.app/api-reference/tv-episodes/external-ids.md): This endpoint get a list of external IDs that have been added to a TV episode. - [Images](https://sirjosh.mintlify.app/api-reference/tv-episodes/images.md): This endpoint get the images that belong to a TV episode. - [Translations](https://sirjosh.mintlify.app/api-reference/tv-episodes/translations.md): This endpoint get the translations that have been added to a TV episode. - [Videos](https://sirjosh.mintlify.app/api-reference/tv-episodes/videos.md): This endpoint get the videos that belong to a TV episode. - [Account States](https://sirjosh.mintlify.app/api-reference/tv-seasons/account-states.md): This endpoint get the rating, watchlist and favourite status. - [Aggregate Credits](https://sirjosh.mintlify.app/api-reference/tv-seasons/aggregate-credits.md): This endpoint get the aggregate credits (cast and crew) that have been added to a TV season. - [Changes](https://sirjosh.mintlify.app/api-reference/tv-seasons/changes.md): This endpoint get the recent changes for a TV season. - [Credits](https://sirjosh.mintlify.app/api-reference/tv-seasons/credits.md): This endpoint retrieves the cast and crew details for a specific season of a TV series. - [Details](https://sirjosh.mintlify.app/api-reference/tv-seasons/details.md): This endpoint query the details of a TV season. - [External IDs](https://sirjosh.mintlify.app/api-reference/tv-seasons/external-ids.md): This endpoint get a list of external IDs that have been added to a TV season. - [Images](https://sirjosh.mintlify.app/api-reference/tv-seasons/images.md): This endpoint get the images that belong to a TV season. - [Translations](https://sirjosh.mintlify.app/api-reference/tv-seasons/translations.md): This endpoint get the translations for a TV season. - [Videos](https://sirjosh.mintlify.app/api-reference/tv-seasons/videos.md): This endpoint get the videos that belong to a TV season. - [Watch Providers](https://sirjosh.mintlify.app/api-reference/tv-seasons/watch-providers.md): This endpoint get the list of streaming providers we have for a TV season. - [Airing Today](https://sirjosh.mintlify.app/api-reference/tv-series-list/airing-today.md): This endpoint get a list of TV shows airing today. - [On The Air](https://sirjosh.mintlify.app/api-reference/tv-series-list/on-the-air.md): This endpoint get a list of TV shows that air in the next 7 days. - [Popular](https://sirjosh.mintlify.app/api-reference/tv-series-list/popular.md): This endpoint get a list of TV shows ordered by popularity. - [Top Rated](https://sirjosh.mintlify.app/api-reference/tv-series-list/top-rated.md): This endpoint get a list of TV shows ordered by rating. - [Account States](https://sirjosh.mintlify.app/api-reference/tv-series/account-states.md): This endpoint get the rating, watchlist and favourite status. - [Add Rating](https://sirjosh.mintlify.app/api-reference/tv-series/add-rating.md): This endpoint rate a TV show and save it to your rated list. - [Aggregate Credits](https://sirjosh.mintlify.app/api-reference/tv-series/aggregate-credits.md): This endpoint get the aggregate credits (cast and crew) that have been added to a TV show. - [Alternative Titles](https://sirjosh.mintlify.app/api-reference/tv-series/alternative-titles.md): This endpoint get the alternative titles that have been added to a TV show. - [Changes](https://sirjosh.mintlify.app/api-reference/tv-series/changes.md): This endpoint get the recent changes for a TV show. - [Content Rating](https://sirjosh.mintlify.app/api-reference/tv-series/content-rating.md): This endpoint get the content ratings that have been added to a TV show. - [Credits](https://sirjosh.mintlify.app/api-reference/tv-series/credits.md): This endpoint get the latest season credits of a TV show. - [Delete Rating](https://sirjosh.mintlify.app/api-reference/tv-series/delete-rating.md): This endpoint delete a rating for a TV series. - [Details](https://sirjosh.mintlify.app/api-reference/tv-series/details.md): This endpoint get the details of a TV show. - [Episode Groups](https://sirjosh.mintlify.app/api-reference/tv-series/episode-groups.md): This endpoint get the episode groups that have been added to a TV show. - [External IDs](https://sirjosh.mintlify.app/api-reference/tv-series/external-ids.md): This endpoint get a list of external IDs that have been added to a TV show. - [Images](https://sirjosh.mintlify.app/api-reference/tv-series/images.md): This endpoint get the images that belong to a TV series. - [Keywords](https://sirjosh.mintlify.app/api-reference/tv-series/keywords.md): This endpoint get a list of keywords that have been added to a TV show. - [Latest](https://sirjosh.mintlify.app/api-reference/tv-series/latest.md): This endpoint get the newest TV show ID. - [Lists](https://sirjosh.mintlify.app/api-reference/tv-series/lists.md): This endpoint get the lists that a TV series has been added to. - [Recommendations](https://sirjosh.mintlify.app/api-reference/tv-series/recommendations.md): This endpoint retrieve recommendations for a particular TV series. - [Reviews](https://sirjosh.mintlify.app/api-reference/tv-series/reviews.md): This endpoint get the reviews that have been added to a TV show. - [Screened Theatrically](https://sirjosh.mintlify.app/api-reference/tv-series/screened-theatrically.md): This endpoint get the seasons and episodes that have screened theatrically. - [Similar](https://sirjosh.mintlify.app/api-reference/tv-series/similar.md): This endpoint get the similar TV shows. - [Tranaslations](https://sirjosh.mintlify.app/api-reference/tv-series/tranaslations.md): This endpoint get the translations that have been added to a TV show. - [Videos](https://sirjosh.mintlify.app/api-reference/tv-series/videos.md): This endpoint get the videos that belong to a TV show. - [Watch Providers](https://sirjosh.mintlify.app/api-reference/tv-series/watch-providers.md): This endpoint get the list of streaming providers we have for a TV show. - [Available Regions](https://sirjosh.mintlify.app/api-reference/watch-providers/available-regions.md): This endpoint get the list of the countries we have watch provider (OTT/streaming) data for. - [Movie Providers](https://sirjosh.mintlify.app/api-reference/watch-providers/movie-providers.md): This endpoint get the list of streaming providers we have for movies. - [TV Providers](https://sirjosh.mintlify.app/api-reference/watch-providers/tv-providers.md): This endpoint get the list of streaming providers we have for TV shows. - [Authentication](https://sirjosh.mintlify.app/authentication.md): This page will show you how to set up your bearer token - [ Introduction](https://sirjosh.mintlify.app/introduction.md): This page introduces us to what TMDB is about - [SDKs and Libraries](https://sirjosh.mintlify.app/library.md): This page provides information about available SDKs, libraries, and client tools, along with installation instructions and usage examples. - [Pagination](https://sirjosh.mintlify.app/pagination.md): This page explains how to handle pagination and filtering when making requests to the API. - [Quickstart](https://sirjosh.mintlify.app/quickstart.md): This page will show you how to make an API Request - [User Authentication](https://sirjosh.mintlify.app/user-authentication.md): This page will show you how to get your session_id - [V3 vs V4](https://sirjosh.mintlify.app/v3-vs-v4.md): This page contans detailed explanation of each version, their features, and the differences between them. ## OpenAPI Specs - [openapi3](https://sirjosh.mintlify.app/api-reference/openapi3.json) - [openapi](https://sirjosh.mintlify.app/api-reference/openapi.json)