> ## Documentation Index
> Fetch the complete documentation index at: https://tvc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists

> This endpoint gets the lists that a movie has been added to.



## OpenAPI

````yaml get /3/movie/{{movie_id}}/lists
openapi: 3.0.3
info:
  title: TMDb Endpoints
  description: >-
    Welcome to the TMDb API! You'll find a well-organized collection of
    endpoints, each helping you fetch different types of movie and TV data. The
    endpoints cover everything from searching for titles and getting details to
    managing lists and accessing ratings, all designed to give you precise
    control over the information you need.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
    description: Test server
  - url: https://api.themoviedb.org/3
    description: Production server
  - url: '{{base_url}}'
    description: Some other server
security: []
tags:
  - name: AUTHENTICATION
    description: The /account/{account_id} gets the public details of an account on TMDB.
  - name: ACCOUNT
    description: >-
      Account endpoints allow users to manage their personal information,
      ratings, watchlists, and other account-related data after authenticating.
  - name: CERTIFICATIONS
    description: >-
      The Certifications endpoints provide lists of movie and TV show content
      rating systems used in various countries.
  - name: CHANGES
    description: >-
      Changes endpoints allow you to track modifications made to movies, TV
      shows, and people in the TMDb database, providing a history of updates and
      enabling you to keep your local data synchronized.
  - name: COLLECTIONS
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
    description: >-
      Discover endpoints are powerful tools for finding movies and TV shows
      based on a wide range of criteria, such as genre, release date, rating,
      keywords, and more, enabling highly customized searches.
  - name: FIND
    description: This folder has find by ID endpoint
  - name: GENRES
    description: >-
      Genres endpoints provide lists of available movie and TV show genres,
      allowing you to categorize and filter content.
  - name: GUEST SESSIONS
    description: >-
      Guest session endpoints allow you to create temporary, unauthenticated
      sessions that grant limited access to certain API features, such as rating
      movies or TV shows without requiring a full user account.
  - name: KEYWORDS
    description: >-
      Keyword endpoints allow you to search for keywords and retrieve detailed
      information about specific keywords and the media associated with them.
  - name: LISTS
    description: >-
      Lists endpoints allow you to create, retrieve, modify, and delete custom
      lists of movies or TV shows.
  - name: MOVIE LIST
    description: >-
      The Movie List endpoints let you retrieve pre-made lists of movies,
      categorized by criteria like popularity, top rated, now playing, or
      upcoming releases.
  - name: MOVIES
    description: >-
      The Movie endpoints allow you to retrieve detailed information about
      movies, including titles, descriptions, cast, crew, ratings, and related
      data.
  - name: NETWORKS
    description: >-
      The NETWORKS endpoints let you retrieve information about television
      networks, such as their names, logos, and origin countries.
  - name: PEOPLE LISTS
    description: >-
      The People Lists endpoints let you retrieve lists of people based on
      criteria like popularity.
  - name: PEOPLE
    description: >-
      The PEOPLE endpoints let you get information about actors, directors, and
      other people involved in movies and TV shows.
  - name: REVIEWS
    description: >-
      The REVIEWS endpoints let you get user-written opinions and ratings about
      movies and TV shows.
  - name: SEARCH
    description: >-
      The "Search" endpoints let you find movies, TV shows, people, and other
      content by typing in keywords or names.
  - name: TRENDING
    description: >-
      The "Trending" endpoints show you what movies, TV shows, and people are
      currently popular or getting a lot of attention right now.
  - name: TV SERIES LISTS
    description: >-
      TV Series Lists endpoints provide access to pre-defined lists of TV shows,
      such as popular, top-rated, or airing today, allowing you to quickly
      retrieve collections of TV series based on specific criteria.
  - name: TV SERIES
    description: >-
      The TV series endpoints provide access to a wealth of information about
      television shows, including details, credits, seasons, episodes,
      recommendations, and more. See each of them below for specific
      information.
  - name: TV SEASONS
    description: >-
      The TV seasons endpoints allow you to retrieve details about specific
      seasons of a TV show, including information about the episodes within that
      season. See them below for specific information on how to use them.
  - name: TV EPISODES
    description: >-
      The TV episode endpoints allow you to retrieve detailed information about
      specific episodes of a TV show, including details like the episode number,
      name, air date, overview, and more. Check them out for specific
      information.
  - name: TV EPISODE GROUPS
    description: >-
      There's only one endpoint in this folder. Check the endpoint to find
      information about it.
  - name: WATCH PROVIDERS
    description: >-
      The Watch Providers endpoints provide information about streaming
      services, rental/purchase platforms, and sometimes even theatrical
      releases in different regions.
paths:
  /3/movie/{{movie_id}}/lists:
    parameters:
      - name: movie_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - MOVIES
      summary: Lists
      description: This endpoint gets the lists that a movie has been added to.
      operationId: lists1
      responses:
        '200':
          description: New Request
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=27071
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sat, 11 Jan 2025 14:47:41 GMT
            ETag:
              schema:
                type: string
                example: W/"c81c1ca2205e2a6d5fa4d353f38e3060"
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 57683e1b4b68ffc4d35501f444414c4c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 8np_zJL6twJuXv4VYN29SzzmGorydUSUcaR6UxpgTz9MddURWGQSBA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-P2
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: MISS, STORE
            x-memc-age:
              schema:
                type: string
                example: '0'
            x-memc-expires:
              schema:
                type: string
                example: '27071'
            x-memc-key:
              schema:
                type: string
                example: 57911921c83402103a3638a744b535c4
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 200
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        description:
                          type: string
                          example: Les films et séries que je possède en DVD.
                        favorite_count:
                          type: number
                          example: 0
                        id:
                          type: number
                          example: 7057603
                        iso_3166_1:
                          type: string
                          example: US
                        iso_639_1:
                          type: string
                          example: en
                        item_count:
                          type: number
                          example: 252
                        list_type:
                          type: string
                          example: movie
                        name:
                          type: string
                          example: Owned
                        poster_path:
                          nullable: true
                          example: null
                    example:
                      - description: Les films et séries que je possède en DVD.
                        favorite_count: 0
                        id: 7057603
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 252
                        list_type: movie
                        name: Owned
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8238235
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11505
                        list_type: movie
                        name: My Movie Library
                        poster_path: null
                      - description: A list of mids found by Mid Hunters
                        favorite_count: 0
                        id: 8272938
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 7500
                        list_type: movie
                        name: Mid Hunting List
                        poster_path: null
                      - description: Master List In Progress
                        favorite_count: 0
                        id: 51108
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11809
                        list_type: movie
                        name: My Movies
                        poster_path: null
                      - description: "Trying to list the movies I have watched, but it may take quite some time to complete it.\r\n\r\nBy the way, I use MyAnimeList's notation system, which is:\r\n\r\n(1)\_Appalling; (2) Horrible; (3) Very Bad; (4) Bad; (5) Average; (6) Fine; (7) Good; (8) Very Good; (9) Great; (10) Masterpiece"
                        favorite_count: 0
                        id: 8303328
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 206
                        list_type: movie
                        name: WATCHED
                        poster_path: null
                      - description: "from the book Ready Player One and Ready Player Two\r\nAll the movie references\r\nSo you can become a true film gunter"
                        favorite_count: 0
                        id: 8506294
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 138
                        list_type: movie
                        name: Ready Player One & Two
                        poster_path: null
                      - description: Blu-rays, DVDs, VHS Tapes
                        favorite_count: 0
                        id: 8498723
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1137
                        list_type: movie
                        name: Quite The Silly Collection
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 126302
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 12515
                        list_type: movie
                        name: Abstrusest 2
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8428066
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 650
                        list_type: movie
                        name: Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7095983
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 175
                        list_type: movie
                        name: Sci-Fi
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7079769
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 2248
                        list_type: movie
                        name: Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 21427
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 2688
                        list_type: movie
                        name: All Movies
                        poster_path: null
                      - description: >-
                          Live-action movies I have seen at some point in my
                          life.
                        favorite_count: 0
                        id: 113214
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 403
                        list_type: movie
                        name: Live-Action Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 137406
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 825
                        list_type: movie
                        name: My Collection
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8231961
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1588
                        list_type: movie
                        name: Movies I've Seen
                        poster_path: null
                      - description: My collection  of DVD's
                        favorite_count: 0
                        id: 33728
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1809
                        list_type: movie
                        name: My Personal Collection...
                        poster_path: null
                      - description: My Blu-ray collection.
                        favorite_count: 0
                        id: 82018
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 418
                        list_type: movie
                        name: Blu-rays
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504586
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1063
                        list_type: movie
                        name: Phil's Watched Films
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8233984
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 823
                        list_type: movie
                        name: Watched 2023- Movie Juice
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7092101
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 13393
                        list_type: movie
                        name: for radarr
                        poster_path: null
                  total_pages:
                    type: number
                    example: 12
                  total_results:
                    type: number
                    example: 236
              examples:
                New Request:
                  value:
                    id: 200
                    page: 1
                    results:
                      - description: Les films et séries que je possède en DVD.
                        favorite_count: 0
                        id: 7057603
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 252
                        list_type: movie
                        name: Owned
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8238235
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11505
                        list_type: movie
                        name: My Movie Library
                        poster_path: null
                      - description: A list of mids found by Mid Hunters
                        favorite_count: 0
                        id: 8272938
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 7500
                        list_type: movie
                        name: Mid Hunting List
                        poster_path: null
                      - description: Master List In Progress
                        favorite_count: 0
                        id: 51108
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11809
                        list_type: movie
                        name: My Movies
                        poster_path: null
                      - description: "Trying to list the movies I have watched, but it may take quite some time to complete it.\r\n\r\nBy the way, I use MyAnimeList's notation system, which is:\r\n\r\n(1)\_Appalling; (2) Horrible; (3) Very Bad; (4) Bad; (5) Average; (6) Fine; (7) Good; (8) Very Good; (9) Great; (10) Masterpiece"
                        favorite_count: 0
                        id: 8303328
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 206
                        list_type: movie
                        name: WATCHED
                        poster_path: null
                      - description: "from the book Ready Player One and Ready Player Two\r\nAll the movie references\r\nSo you can become a true film gunter"
                        favorite_count: 0
                        id: 8506294
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 138
                        list_type: movie
                        name: Ready Player One & Two
                        poster_path: null
                      - description: Blu-rays, DVDs, VHS Tapes
                        favorite_count: 0
                        id: 8498723
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1137
                        list_type: movie
                        name: Quite The Silly Collection
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 126302
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 12515
                        list_type: movie
                        name: Abstrusest 2
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8428066
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 650
                        list_type: movie
                        name: Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7095983
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 175
                        list_type: movie
                        name: Sci-Fi
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7079769
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 2248
                        list_type: movie
                        name: Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 21427
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 2688
                        list_type: movie
                        name: All Movies
                        poster_path: null
                      - description: >-
                          Live-action movies I have seen at some point in my
                          life.
                        favorite_count: 0
                        id: 113214
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 403
                        list_type: movie
                        name: Live-Action Movies
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 137406
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 825
                        list_type: movie
                        name: My Collection
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8231961
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1588
                        list_type: movie
                        name: Movies I've Seen
                        poster_path: null
                      - description: My collection  of DVD's
                        favorite_count: 0
                        id: 33728
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1809
                        list_type: movie
                        name: My Personal Collection...
                        poster_path: null
                      - description: My Blu-ray collection.
                        favorite_count: 0
                        id: 82018
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 418
                        list_type: movie
                        name: Blu-rays
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504586
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 1063
                        list_type: movie
                        name: Phil's Watched Films
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8233984
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 823
                        list_type: movie
                        name: Watched 2023- Movie Juice
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 7092101
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 13393
                        list_type: movie
                        name: for radarr
                        poster_path: null
                    total_pages: 12
                    total_results: 236
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````