> ## Documentation Index > Fetch the complete documentation index at: https://emiloju.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a list > This endpoint is used to retrieve a user's list by it's ID. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/list/{list_id} openapi: 3.0.3 info: title: Endpoints description: This section contains all the endpoints used in the documentation. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: Authentication description: This section contains all endpoints used for authentication - name: Accounts description: This section contains account-specific endpoints. - name: Favorites description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows, episodes to favorites, and also to get a list of favorites for the account. - name: Movies description: >- This section contains an endpoint to add a movie to favorites, and another to get a list of favorite movies for a TMDB account. - name: TV shows description: >- This section contains an endpoint to get the favorite TV shows for an account. - name: Watchlist description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows to watchlist, and also to get a list of watchlist for the account. - name: Movies1 description: >- This section contains an endpoint that allows a TMDB account to add a movie to watchlist, and another to get the movies in a watchlist. - name: TV shows1 description: >- This section contains an endpoint used to get TV shows in an account's watchlist. - name: Ratings description: >- This section contains endpoints used to get all movies, TV Shows, and episodes rated by a TMDB account. - name: Movies12 description: >- This section contains an endpoint used to get a list of movies rated by a TMDB account. - name: TV shows12 description: >- This section contains an endpoint used to get a list of TV shows rated by a TMDB account. - name: Episodes description: >- This section contains an endpoint used to get a list of episodes rated by a TMDB account. - name: Lists description: Endpoints for a TMDB account lists. - name: Guest sessions description: This section contains all endpoints accessible by a guest session. - name: Movies description: For movies. - name: TV episodes description: >- This section contains all endpoints used to retrieve data for all TV episodes. - name: TV seasons description: >- This section contains all endpoints used to retrieve data for all TV seasons. - name: TV series description: >- This section contains all endpoints used to retrieve data for all TV series. - name: TV series lists description: This section contains all endpoints used to list TV series. - name: TV episode groups description: This section contains an endpoint used to retrieve data for TV episodes. - name: Watch providers description: Get available regions. - name: People description: About people lists. - name: Companies description: >- This section contains all endpoints used to retrieve data for supported companies. - name: Discover description: This section contains all endpoints used to discover movies and TV shows. - name: Recent changes description: >- This section contains all endpoints used to get recent changes in the TMDB database. - name: Credit description: This section contains an endpoint used to retrieve movie credits. - name: Certifications description: >- This section contains all endpoints used to get certification for movies and TV shows. - name: Collections description: This section contains all endpoints used to retrieve data for collections - name: Configuration description: >- This section contains all endpoints used to retrieve data on TMDB's configurations. - name: Find description: >- This section contains an endpoint used to search the TMDB database by External ID. - name: Genres description: This section contains endpoints related to genres. - name: Keywords description: >- This section contains an endpoint used to get keywords in the database by an ID. - name: Movie lists description: >- This section contains all endpoints used to retrieve movies by multiple search filters. - name: Networks description: For network endpoints. - name: Reviews description: For reviews endpoints. - name: Search description: For search endpoints. - name: Trending description: For trending videos. paths: /3/list/{list_id}: get: tags: - Accounts - Lists summary: Retrieve a list description: This endpoint is used to retrieve a user's list by it's ID. operationId: retrieveAList parameters: - $ref: aaf1dc45-ba18-47cd-951f-ffc5fc73b15e - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/page' responses: '200': description: Request successful headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: max-age=0, private, must-revalidate Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Wed, 01 Jan 2025 21:57:45 GMT ETag: schema: type: string example: W/"eeb48a72e4ceac2044c787c1523a185f" 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 b3d672c454c45e15da48dfcb26c8e40e.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: 61fdgqhqPB5LkqiuTQxDKIIeXGEiFKPT-4tsjxOZOiUDI8jyGwwpgA== X-Amz-Cf-Pop: schema: type: string example: CDG50-C1 X-Cache: schema: type: string example: Miss from cloudfront content: application/json: schema: type: object properties: created_by: type: string example: Emiloju description: The creator of the list description: type: string example: List of movies and tv shows I plan to watch. description: The description for the list favorite_count: type: number example: 0 description: >- The number of times the list item has been marked favorite by users id: type: number example: 8500157 description: The unique identifier for the list iso_639_1: type: string example: en description: >- A two letter code that represents the language used in the response. item_count: type: number example: 2 description: The number of items in the list items: type: array items: type: object properties: adult: type: boolean example: false description: >- Indicates if the item contains adult content (true or false) backdrop_path: type: string example: /5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg description: Path to the item's backdrop path first_air_date: type: string example: '2006-10-05' description: >- The release date of the item's first episode (if the item is a TV show). genre_ids: type: array items: type: number example: 16 example: - 16 - 10765 - 10759 - 18 description: List of genre IDs associated with the item id: type: number example: 31724 description: A unique identifier for the item name: type: string example: 'Code Geass: Lelouch of the Rebellion' description: The item's name origin_country: type: array items: type: string example: JP example: - JP description: >- The list of countries where the item (Movie or TV show) was originally produced. original_language: type: string example: ja description: >- The item's original language code (e.g, "ja" for Japanese) original_name: type: string example: コードギアス 反逆のルルーシュ description: The item's original name/title (if it's a TV show) original_title: type: string example: Le Cinquième Élément description: The item's original title (if it's a movie) overview: type: string example: >- Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show... description: Brief summary or description of the items popularity: type: number example: 109.544 description: >- A numeric value that represents the item's popularity. poster_path: type: string example: /n8ju74bg2k5MmDn5RBF6qMbhIlG.jpg description: The path to the item's poster image release_date: type: string example: '1997-05-02' description: The date the item was released (YYYY-MM-DD). title: type: string example: The Fifth Element description: The item's title video: type: boolean example: false description: >- A boolean value that indicates if the item is a video vote_average: type: number example: 8.4 description: Average user rating for the item on a scale of 1-10 vote_count: type: number example: 747 description: The total number of user votes for the item. example: - adult: false backdrop_path: /5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg first_air_date: '2006-10-05' genre_ids: - 16 - 10765 - 10759 - 18 id: 31724 media_type: tv name: 'Code Geass: Lelouch of the Rebellion' origin_country: - JP original_language: ja original_name: コードギアス 反逆のルルーシュ overview: >- Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show... popularity: 109.544 poster_path: /n8ju74bg2k5MmDn5RBF6qMbhIlG.jpg vote_average: 8.4 vote_count: 747 - adult: false backdrop_path: /wgvc3PmjQGtYYDWaeuV867mnFDs.jpg genre_ids: - 878 - 28 - 12 id: 18 media_type: movie original_language: fr original_title: Le Cinquième Élément overview: >- In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity. popularity: 65.447 poster_path: /fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg release_date: '1997-05-02' title: The Fifth Element video: false vote_average: 7.553 vote_count: 10758 description: An array of items in the list name: type: string example: To be watched description: The list's name page: $ref: '#/components/schemas/page' poster_path: nullable: true example: null description: The path to the item's poster image total_pages: $ref: '#/components/schemas/totalPages' total_results: $ref: '#/components/schemas/totalResults' examples: Example response: value: created_by: Emiloju description: A list of movies for the holiday season favorite_count: 0 id: 8504581 iso_639_1: en item_count: 0 items: [] name: Christmas movie list. page: 1 poster_path: null total_pages: 1 total_results: 0 components: parameters: language: in: query name: language schema: type: string example: en-US description: > The language and region of the content, represented by an ISO 639-1 and ISO 3166-1 code combination (e.g, en-US for English, United States.). Defaults to en-US. page: in: query name: page schema: type: integer example: 1 description: A specific page number to get results for. Defaults to 1 schemas: page: type: number example: 1 description: Current page number of the results totalPages: type: number example: 1 description: The total number of pages returned in the response totalResults: type: number example: 1 description: The total number of results returned in the response securitySchemes: bearerAuth: type: http scheme: bearer ````