--- updatedAt: 2025-10-01T20:31:04.000Z agentTools: projectIndex: https://developer.themoviedb.org/v4/llms.txt --- # Watchlist Movies Get a users movie watchlist. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "tmdb-api", "version": "4" }, "servers": [ { "url": "https://api.themoviedb.org" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/4/account/{account_object_id}/movie/watchlist": { "get": { "summary": "Watchlist Movies", "description": "Get a users movie watchlist.", "operationId": "account-movie-watchlist", "parameters": [ { "name": "account_object_id", "in": "path", "schema": { "type": "string", "default": "<>" }, "required": true }, { "name": "page", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "language", "in": "query", "schema": { "type": "string", "default": "en-US" } }, { "name": "sort_by", "in": "query", "schema": { "type": "string", "enum": [ "created_at.asc", "created_at.desc" ], "default": "created_at.asc" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\"page\":1,\"results\":[{\"adult\":false,\"backdrop_path\":\"/9sfVyE3sP2dkCwDyV7UlYP5TAAR.jpg\",\"id\":823754,\"title\":\"Bo Burnham: Inside\",\"original_language\":\"en\",\"original_title\":\"Bo Burnham: Inside\",\"overview\":\"Stuck in COVID-19 lockdown, US comedian and musician Bo Burnham attempts to stay sane and happy by writing, shooting and performing a one-man comedy special.\",\"poster_path\":\"/ku1UvTWYvhFQbSesOD6zteY7bXT.jpg\",\"media_type\":\"movie\",\"genre_ids\":[35,18],\"popularity\":11.904,\"release_date\":\"2021-07-22\",\"video\":false,\"vote_average\":8.178,\"vote_count\":352},{\"adult\":false,\"backdrop_path\":\"/4XKqxgjRJs3YtH5j1Eli5y6gtno.jpg\",\"id\":542178,\"title\":\"The French Dispatch\",\"original_language\":\"en\",\"original_title\":\"The French Dispatch\",\"overview\":\"The staff of an American magazine based in France puts out its last issue, with stories featuring an artist sentenced to life imprisonment, student riots, and a kidnapping resolved by a chef.\",\"poster_path\":\"/pMTMSKBEe5sMg1ZxWCy9YWLuyln.jpg\",\"media_type\":\"movie\",\"genre_ids\":[35,18,10749],\"popularity\":25.628,\"release_date\":\"2021-10-21\",\"video\":false,\"vote_average\":7.152,\"vote_count\":2015},{\"adult\":false,\"backdrop_path\":\"/qK7Ssnrfvrt65F66A1thvehfQg2.jpg\",\"id\":420821,\"title\":\"Chip 'n Dale: Rescue Rangers\",\"original_language\":\"en\",\"original_title\":\"Chip 'n Dale: Rescue Rangers\",\"overview\":\"Decades since their successful television series was canceled, Chip has succumbed to a life of suburban domesticity as an insurance salesman. Dale, meanwhile, has had CGI surgery and works the nostalgia convention circuit, desperate to relive his glory days. When a former cast mate mysteriously disappears, Chip and Dale must repair their broken friendship and take on their Rescue Rangers detective personas once again to save their friend’s life.\",\"poster_path\":\"/7UGmn8TyWPPzkjhLUW58cOUHjPS.jpg\",\"media_type\":\"movie\",\"genre_ids\":[16,10751,35,12,9648],\"popularity\":73.26,\"release_date\":\"2022-05-20\",\"video\":false,\"vote_average\":7.02,\"vote_count\":991},{\"adult\":false,\"backdrop_path\":\"/r6aqhlmJmu8Dv5E7QYEruaEXKYm.jpg\",\"id\":758866,\"title\":\"Drive My Car\",\"original_language\":\"ja\",\"original_title\":\"ドライブ・マイ・カー\",\"overview\":\"Yusuke Kafuku, a stage actor and director, still unable, after two years, to cope with the loss of his beloved wife, accepts to direct Uncle Vanya at a theater festival in Hiroshima. There he meets Misaki, an introverted young woman, appointed to drive his car. In between rides, secrets from the past and heartfelt confessions will be unveiled.\",\"poster_path\":\"/3cOsf5HBjPK2QCz9ebQlGHNnE7y.jpg\",\"media_type\":\"movie\",\"genre_ids\":[18],\"popularity\":16.5,\"release_date\":\"2021-08-18\",\"video\":false,\"vote_average\":7.409,\"vote_count\":937},{\"adult\":false,\"backdrop_path\":\"/zGLHX92Gk96O1DJvLil7ObJTbaL.jpg\",\"id\":338953,\"title\":\"Fantastic Beasts: The Secrets of Dumbledore\",\"original_language\":\"en\",\"original_title\":\"Fantastic Beasts: The Secrets of Dumbledore\",\"overview\":\"Professor Albus Dumbledore knows the powerful, dark wizard Gellert Grindelwald is moving to seize control of the wizarding world. Unable to stop him alone, he entrusts magizoologist Newt Scamander to lead an intrepid team of wizards and witches. They soon encounter an array of old and new beasts as they clash with Grindelwald's growing legion of followers.\",\"poster_path\":\"/jrgifaYeUtTnaH7NF5Drkgjg2MB.jpg\",\"media_type\":\"movie\",\"genre_ids\":[14,12,10751],\"popularity\":156.49,\"release_date\":\"2022-04-06\",\"video\":false,\"vote_average\":6.76,\"vote_count\":3515},{\"adult\":false,\"backdrop_path\":\"/iKUwhA4DUxMcNKu5lLSbDFwwilk.jpg\",\"id\":453395,\"title\":\"Doctor Strange in the Multiverse of Madness\",\"original_language\":\"en\",\"original_title\":\"Doctor Strange in the Multiverse of Madness\",\"overview\":\"Doctor Strange, with the help of mystical allies both old and new, traverses the mind-bending and dangerous alternate realities of the Multiverse to confront a mysterious new adversary.\",\"poster_path\":\"/9Gtg2DzBhmYamXBS1hKAhiwbBKS.jpg\",\"media_type\":\"movie\",\"genre_ids\":[14,28,12],\"popularity\":247.478,\"release_date\":\"2022-05-04\",\"video\":false,\"vote_average\":7.382,\"vote_count\":7372},{\"adult\":false,\"backdrop_path\":\"/4OTYefcAlaShn6TGVK33UxLW9R7.jpg\",\"id\":476669,\"title\":\"The King's Man\",\"original_language\":\"en\",\"original_title\":\"The King's Man\",\"overview\":\"As a collection of history's worst tyrants and criminal masterminds gather to plot a war to wipe out millions, one man must race against time to stop them.\",\"poster_path\":\"/mpOzVPDFDI15WaKV6dqpYp441rZ.jpg\",\"media_type\":\"movie\",\"genre_ids\":[28,12,53,10752,9648],\"popularity\":97.255,\"release_date\":\"2021-12-22\",\"video\":false,\"vote_average\":6.826,\"vote_count\":3679},{\"adult\":false,\"backdrop_path\":\"/fqw8nJLPRgKRyFSDC0xBsC06NGC.jpg\",\"id\":639933,\"title\":\"The Northman\",\"original_language\":\"en\",\"original_title\":\"The Northman\",\"overview\":\"Prince Amleth is on the verge of becoming a man when his father is brutally murdered by his uncle, who kidnaps the boy's mother. Two decades later, Amleth is now a Viking who's on a mission to save his mother, kill his uncle and avenge his father.\",\"poster_path\":\"/aSSJMnHknzKjlZ6zybwD7eyJ4Po.jpg\",\"media_type\":\"movie\",\"genre_ids\":[28,12,14],\"popularity\":121.634,\"release_date\":\"2022-04-07\",\"video\":false,\"vote_average\":7.1,\"vote_count\":3344},{\"adult\":false,\"backdrop_path\":\"/c6H7Z4u73ir3cIoCteuhJh7UCAR.jpg\",\"id\":524434,\"title\":\"Eternals\",\"original_language\":\"en\",\"original_title\":\"Eternals\",\"overview\":\"The Eternals are a team of ancient aliens who have been living on Earth in secret for thousands of years. When an unexpected tragedy forces them out of the shadows, they are forced to reunite against mankind’s most ancient enemy, the Deviants.\",\"poster_path\":\"/lFByFSLV5WDJEv3KabbdAF959F2.jpg\",\"media_type\":\"movie\",\"genre_ids\":[878,28,12],\"popularity\":114.369,\"release_date\":\"2021-11-03\",\"video\":false,\"vote_average\":6.972,\"vote_count\":7093},{\"adult\":false,\"backdrop_path\":\"/lMjY6kMBOHhloz2Ul16fLJn8xuw.jpg\",\"id\":591538,\"title\":\"The Tragedy of Macbeth\",\"original_language\":\"en\",\"original_title\":\"The Tragedy of Macbeth\",\"overview\":\"Macbeth, the Thane of Glamis, receives a prophecy from a trio of witches that one day he will become King of Scotland. Consumed by ambition and spurred to action by his wife, Macbeth murders his king and takes the throne for himself.\",\"poster_path\":\"/wzQjzBq1ISZHoDKoAlxSWuiL3hO.jpg\",\"media_type\":\"movie\",\"genre_ids\":[18,10752],\"popularity\":14.319,\"release_date\":\"2021-12-05\",\"video\":false,\"vote_average\":6.982,\"vote_count\":586},{\"adult\":false,\"backdrop_path\":\"/4LrL40XecjGLRpX5I2gzMTUt04l.jpg\",\"id\":617653,\"title\":\"The Last Duel\",\"original_language\":\"en\",\"original_title\":\"The Last Duel\",\"overview\":\"King Charles VI declares that Knight Jean de Carrouges settle his dispute with his squire, Jacques Le Gris, by challenging him to a duel.\",\"poster_path\":\"/zjrJE0fpzPvX8saJXj8VNfcjBoU.jpg\",\"media_type\":\"movie\",\"genre_ids\":[28,18,36],\"popularity\":42.746,\"release_date\":\"2021-10-13\",\"video\":false,\"vote_average\":7.487,\"vote_count\":2759},{\"adult\":false,\"backdrop_path\":\"/hiKmpZMGZsrkA3cdce8a7Dpos1j.jpg\",\"id\":496243,\"title\":\"Parasite\",\"original_language\":\"ko\",\"original_title\":\"기생충\",\"overview\":\"All unemployed, Ki-taek's family takes peculiar interest in the wealthy and glamorous Parks for their livelihood until they get entangled in an unexpected incident.\",\"poster_path\":\"/7IiTTgloJzvGI1TAYymCfbfl3vT.jpg\",\"media_type\":\"movie\",\"genre_ids\":[35,53,18],\"popularity\":66.897,\"release_date\":\"2019-05-30\",\"video\":false,\"vote_average\":8.515,\"vote_count\":15672},{\"adult\":false,\"backdrop_path\":\"/xkXEP5HhFuOAxTzbj770jVpfsyo.jpg\",\"id\":664300,\"title\":\"Shiva Baby\",\"original_language\":\"en\",\"original_title\":\"Shiva Baby\",\"overview\":\"College student Danielle must cover her tracks when she unexpectedly runs into her sugar daddy at a shiva - with her parents, ex-girlfriend and family friends also in attendance.\",\"poster_path\":\"/5IBJwMPSCS5XdRT7BO1ZMreFOis.jpg\",\"media_type\":\"movie\",\"genre_ids\":[35,18],\"popularity\":10.465,\"release_date\":\"2021-04-02\",\"video\":false,\"vote_average\":7.194,\"vote_count\":403},{\"adult\":false,\"backdrop_path\":\"/6MKr3KgOLmzOP6MSuZERO41Lpkt.jpg\",\"id\":337404,\"title\":\"Cruella\",\"original_language\":\"en\",\"original_title\":\"Cruella\",\"overview\":\"In 1970s London amidst the punk rock revolution, a young grifter named Estella is determined to make a name for herself with her designs. She befriends a pair of young thieves who appreciate her appetite for mischief, and together they are able to build a life for themselves on the London streets. One day, Estella’s flair for fashion catches the eye of the Baroness von Hellman, a fashion legend who is devastatingly chic and terrifyingly haute. But their relationship sets in motion a course of events and revelations that will cause Estella to embrace her wicked side and become the raucous, fashionable and revenge-bent Cruella.\",\"poster_path\":\"/wToO8opxkGwKgSfJ1JK8tGvkG6U.jpg\",\"media_type\":\"movie\",\"genre_ids\":[35,80],\"popularity\":162.575,\"release_date\":\"2021-05-26\",\"video\":false,\"vote_average\":8.08,\"vote_count\":8158},{\"adult\":false,\"backdrop_path\":\"/i1GT0e6Crg6UezT3ibXnMS3pBAd.jpg\",\"id\":652837,\"title\":\"Josee, the Tiger and the Fish\",\"original_language\":\"ja\",\"original_title\":\"ジョゼと虎と魚たち\",\"overview\":\"With dreams of diving abroad, Tsuneo gets a job assisting Josee, an artist whose imagination takes her far beyond her wheelchair. But when the tide turns against them, they push each other to places they never thought possible, and inspire a love fit for a storybook.\",\"poster_path\":\"/xAbSLi61npWyVs5M0yxin3dKcGO.jpg\",\"media_type\":\"movie\",\"genre_ids\":[16,18,10749],\"popularity\":30.502,\"release_date\":\"2020-12-25\",\"video\":false,\"vote_average\":8.4,\"vote_count\":333},{\"adult\":false,\"backdrop_path\":\"/fwrqW8Lp5VQuppFrODd4iJ8LySE.jpg\",\"id\":335787,\"title\":\"Uncharted\",\"original_language\":\"en\",\"original_title\":\"Uncharted\",\"overview\":\"A young street-smart, Nathan Drake and his wisecracking partner Victor “Sully” Sullivan embark on a dangerous pursuit of “the greatest treasure never found” while also tracking clues that may lead to Nathan’s long-lost brother.\",\"poster_path\":\"/rJHC1RUORuUhtfNb4Npclx0xnOf.jpg\",\"media_type\":\"movie\",\"genre_ids\":[28,12],\"popularity\":197.28,\"release_date\":\"2022-02-10\",\"video\":false,\"vote_average\":7.03,\"vote_count\":4652},{\"adult\":false,\"backdrop_path\":\"/mv4lRdLy201m3pndE68MuIKofpt.jpg\",\"id\":790142,\"title\":\"The Royal Treatment\",\"original_language\":\"en\",\"original_title\":\"The Royal Treatment\",\"overview\":\"Isabella runs her own salon and isn’t afraid to speak her mind, while Prince Thomas runs his own country and is about to marry for duty rather than love. When Izzy and her fellow stylists get the opportunity of a lifetime to do the hair for the royal wedding, she and Prince Thomas learn that taking control of their own destiny requires following their hearts.\",\"poster_path\":\"/mYAv0YUoXJzLxIdEirOken8Quwf.jpg\",\"media_type\":\"movie\",\"genre_ids\":[10749,35],\"popularity\":24.305,\"release_date\":\"2022-01-20\",\"video\":false,\"vote_average\":6.73,\"vote_count\":682},{\"adult\":false,\"backdrop_path\":\"/mu8RKavbv7Ml48twHQ6XVk7zw8e.jpg\",\"id\":796499,\"title\":\"Army of Thieves\",\"original_language\":\"en\",\"original_title\":\"Army of Thieves\",\"overview\":\"A mysterious woman recruits bank teller Ludwig Dieter to lead a group of aspiring thieves on a top-secret heist during the early stages of the zombie apocalypse.\",\"poster_path\":\"/j04Oepj3LGTWSb1ltXm0pcy50Xq.jpg\",\"media_type\":\"movie\",\"genre_ids\":[80,35],\"popularity\":52.483,\"release_date\":\"2021-10-27\",\"video\":false,\"vote_average\":6.882,\"vote_count\":1651},{\"adult\":false,\"backdrop_path\":\"/8MRDdTrh0O6iG60d4UoepxVI0lj.jpg\",\"id\":649928,\"title\":\"Robin Robin\",\"original_language\":\"en\",\"original_title\":\"Robin Robin\",\"overview\":\"A bird raised by mice begins to question where she belongs and sets off on a daring journey of self-discovery.\",\"poster_path\":\"/bKIdlJbd17rrIm4oZzhXTbmqpon.jpg\",\"media_type\":\"movie\",\"genre_ids\":[16,12,10751],\"popularity\":15.133,\"release_date\":\"2021-10-09\",\"video\":false,\"vote_average\":7.062,\"vote_count\":146},{\"adult\":false,\"backdrop_path\":\"/bGJ7t4JX99ejbfVmNL1ZZvsBvkb.jpg\",\"id\":612654,\"title\":\"Fantastic Fungi\",\"original_language\":\"en\",\"original_title\":\"Fantastic Fungi\",\"overview\":\"A vivid journey into the mysterious subterranean world of mycelium and its fruit— the mushroom. A story that begins 3.5 billion years ago, fungi makes the soil that supports life, connecting vast systems of roots from plants and trees all over the planet, like an underground Internet. Through the eyes of renowned mycologist Paul Stamets, professor of forest ecology Suzanne Simard, best selling author Michael Pollan, food naturalist Eugenia Bone and others, we experience the power, beauty and complexity of the fungi kingdom.\",\"poster_path\":\"/giIGfFqirPk3I2azp8Ow98oOnzG.jpg\",\"media_type\":\"movie\",\"genre_ids\":[99],\"popularity\":12.472,\"release_date\":\"2019-08-30\",\"video\":false,\"vote_average\":7.262,\"vote_count\":124},{\"adult\":false,\"backdrop_path\":\"/zxWAv1A34kdYslBi4ekMDtgIGUt.jpg\",\"id\":566525,\"title\":\"Shang-Chi and the Legend of the Ten Rings\",\"original_language\":\"en\",\"original_title\":\"Shang-Chi and the Legend of the Ten Rings\",\"overview\":\"Shang-Chi must confront the past he thought he left behind when he is drawn into the web of the mysterious Ten Rings organization.\",\"poster_path\":\"/d08HqqeBQSwN8i8MEvpsZ8Cb438.jpg\",\"media_type\":\"movie\",\"genre_ids\":[28,12,14],\"popularity\":146.504,\"release_date\":\"2021-09-01\",\"video\":false,\"vote_average\":7.617,\"vote_count\":8013}],\"total_pages\":4,\"total_results\":80}" } }, "schema": { "type": "object", "properties": { "page": { "type": "integer", "example": 1, "default": 0 }, "results": { "type": "array", "items": { "type": "object", "properties": { "adult": { "type": "boolean", "example": false, "default": true }, "backdrop_path": { "type": "string", "example": "/9sfVyE3sP2dkCwDyV7UlYP5TAAR.jpg" }, "id": { "type": "integer", "example": 823754, "default": 0 }, "title": { "type": "string", "example": "Bo Burnham: Inside" }, "original_language": { "type": "string", "example": "en" }, "original_title": { "type": "string", "example": "Bo Burnham: Inside" }, "overview": { "type": "string", "example": "Stuck in COVID-19 lockdown, US comedian and musician Bo Burnham attempts to stay sane and happy by writing, shooting and performing a one-man comedy special." }, "poster_path": { "type": "string", "example": "/ku1UvTWYvhFQbSesOD6zteY7bXT.jpg" }, "media_type": { "type": "string", "example": "movie" }, "genre_ids": { "type": "array", "items": { "type": "integer", "example": 35, "default": 0 } }, "popularity": { "type": "number", "example": 11.904, "default": 0 }, "release_date": { "type": "string", "example": "2021-07-22" }, "video": { "type": "boolean", "example": false, "default": true }, "vote_average": { "type": "number", "example": 8.178, "default": 0 }, "vote_count": { "type": "integer", "example": 352, "default": 0 } } } }, "total_pages": { "type": "integer", "example": 4, "default": 0 }, "total_results": { "type": "integer", "example": 80, "default": 0 } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```