> ## Documentation Index > Fetch the complete documentation index at: https://starlight.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Details > This endpoint retrieves the details of a list. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/list/{{list_id}} openapi: 3.0.3 info: title: The Movie Database API description: >- Welcome to the third version of The Movie Database (TMDB) API. Our API provides you with vast access to a range of movies, TV shows, actor information, and images. With the TMDB API, you can easily integrate any of these functionalities in your application. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: Collection security: - bearerAuth: [] tags: - name: Validate Key - name: Authentication - name: Guest Sessions - name: Configuration - name: Account - name: Search - name: Discover - name: Find - name: Keyword - name: Lists - name: V3 vs V4 description: >- There is version 4 (v4) for our list API. It contains several advanced improvements that differentiate it from the version 3 (v3) list. Although v3 lists will continue to work, you can only access these features if you switch to v4 lists. Some of the new improvements you can access on v4 lists include: - You can Import "unlimited" items in a single request - You can use mixed-type (movie and TV) lists - You can use private lists - You can add and use comments per item - There are more sort options - They are faster Check the v4 [documentation ](https://developer.themoviedb.org/v4/docs/getting-started) for more information. - name: Collections - name: Companies - name: Networks - name: Trending - name: Movies - name: Movie Lists - name: TV Series - name: TV Series Lists - name: TV Seasons - name: TV Providers - name: TV Episode Groups - name: Watch Providers - name: People - name: People List - name: Genre - name: Changes - name: Credits - name: Certifications paths: /3/list/{{list_id}}: parameters: - name: list_id in: path description: >- This represents the list ID. Get it [here](https://starlight.mintlify.app/api-reference/listid) required: true schema: type: string get: tags: - Lists summary: Details description: This endpoint retrieves the details of a list. operationId: details4 parameters: - name: language in: query schema: type: string example: en description: This represents the language. - name: page in: query schema: type: string example: '1' description: This represents the page number. responses: '200': description: Details 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: Fri, 03 Jan 2025 20:54:06 GMT ETag: schema: type: string example: W/"9fdffbbee4d9950329b5b8429ab37805" 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 c84ecfd128e1f4c41a53a2b42410f3b8.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: P37wHKbJw2H8Rcn3AUQ5_hbnfUH8qsuxesFymfFI1NlsxLlU1Gatzg== X-Amz-Cf-Pop: schema: type: string example: IAD89-C3 X-Cache: schema: type: string example: Miss from cloudfront content: application/json: schema: type: object properties: created_by: type: string example: Gloria Tejuosho description: type: string example: '' favorite_count: type: number example: 0 id: type: number example: 8504994 iso_639_1: type: string example: en item_count: type: number example: 1 items: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /7yD0xhcx600Ng2XBElVE4eN4bE7.jpg genre_ids: type: array items: type: number example: 28 example: - 28 - 878 id: type: number example: 32740 media_type: type: string example: movie original_language: type: string example: hi original_title: type: string example: कृष overview: type: string example: >- In Singapore, Krishna is forced by circumstances to use his superpowers and become a masked superhero named Krrish, before getting drawn towards his lost legacy. popularity: type: number example: 11.536 poster_path: type: string example: /Apd4UKesyTmpDutEjNVHP45kvBi.jpg release_date: type: string example: '2006-06-23' title: type: string example: Krrish video: type: boolean example: false vote_average: type: number example: 6.3 vote_count: type: number example: 232 example: - adult: false backdrop_path: /7yD0xhcx600Ng2XBElVE4eN4bE7.jpg genre_ids: - 28 - 878 id: 32740 media_type: movie original_language: hi original_title: कृष overview: >- In Singapore, Krishna is forced by circumstances to use his superpowers and become a masked superhero named Krrish, before getting drawn towards his lost legacy. popularity: 11.536 poster_path: /Apd4UKesyTmpDutEjNVHP45kvBi.jpg release_date: '2006-06-23' title: Krrish video: false vote_average: 6.3 vote_count: 232 name: type: string example: My List page: type: number example: 1 poster_path: nullable: true example: null total_pages: type: number example: 1 total_results: type: number example: 1 examples: Details: value: created_by: Gloria Tejuosho description: '' favorite_count: 0 id: 8504994 iso_639_1: en item_count: 1 items: - adult: false backdrop_path: /7yD0xhcx600Ng2XBElVE4eN4bE7.jpg genre_ids: - 28 - 878 id: 32740 media_type: movie original_language: hi original_title: कृष overview: >- In Singapore, Krishna is forced by circumstances to use his superpowers and become a masked superhero named Krrish, before getting drawn towards his lost legacy. popularity: 11.536 poster_path: /Apd4UKesyTmpDutEjNVHP45kvBi.jpg release_date: '2006-06-23' title: Krrish video: false vote_average: 6.3 vote_count: 232 name: My List page: 1 poster_path: null total_pages: 1 total_results: 1 components: securitySchemes: bearerAuth: type: http scheme: bearer ````