> ## Documentation Index > Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Details > Get the top level details of a movie by ID. ## OpenAPI ````yaml api-reference/openapi3.json get /3/movie/{movie_id} openapi: 3.0.3 info: title: The Movie Database version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: AUTHENTICATION - name: ACCOUNT - name: CERTIFICATIONS - name: CHANGES - name: COLLECTIONS - name: COMPANY - name: CONFIGURATION - name: CREDIT - name: DISCOVER - name: FIND - name: GENRES - name: GUEST SESSIONS - name: KEYWORDS - name: LISTS - name: MOVIE LISTS - name: MOVIES - name: NETWORKS - name: PEOPLE LIST - name: PEOPLE - name: REVIEWS - name: SEARCH - name: TRENDING - name: TV SERIES LIST - name: TV SERIES - name: TV SEASONS - name: TV EPISODES - name: TV EPISODE GROUP - name: WATCH PROVIDERS paths: /3/movie/{movie_id}: get: tags: - MOVIES summary: Details description: Get the top level details of a movie by ID. operationId: details7 parameters: - $ref: '#/components/parameters/append_to_response' - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/movie_id' responses: '200': description: details headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=9927 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 03 Jan 2025 22:26:00 GMT ETag: schema: type: string example: W/"074e82d5ce91b8e21650eab3ed54fee5" 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 8d6071bd169bbf5fd46638140132b1d0.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: Fb6ScmzU449P8FE_3p8uPAvK286fwuzQqCpW7crUlrfCUE2P4qd8qw== X-Amz-Cf-Pop: schema: type: string example: IAD89-C3 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: HIT x-memc-age: schema: type: string example: '15128' x-memc-expires: schema: type: string example: '9927' x-memc-key: schema: type: string example: 936dd93ad51c3ddbb8adf10ceb3af43d content: application/json: schema: type: object properties: adult: type: boolean example: false description: >- A boolean indicating whether the movie is intended for an adult audience (true if it contains adult content, false otherwise). backdrop_path: type: string example: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg description: >- A string representing the path to the movie's backdrop image. belongs_to_collection: type: object properties: backdrop_path: type: string example: /1VdLvSIeHuwqCT13H9EafxCacGB.jpg description: Path to the collection's backdrop image. id: type: number example: 1069584 description: Unique identifier for the collection. name: type: string example: Gladiator Collection description: Name of the collection (e.g, "Gladiator Collection"). poster_path: type: string example: /r7uyUOB6fmmPumWwHiV7Hn2kUbL.jpg description: Path to the collection's poster image. description: >- An object containing information about collections that this movie belongs to. budget: type: number example: 310000000 description: >- The estimated production budget of the movie, measured in US dollars. genres: type: array items: type: object properties: id: type: number example: 28 description: Unique identifier for the genre. name: type: string example: Action description: Name of the genre. example: - id: 28 name: Action - id: 12 name: Adventure - id: 18 name: Drama description: An array of objects representing the genres of the movie homepage: type: string example: https://www.gladiator.movie description: >- A URL to the official website of the movie, which may provide more information, trailers, or promotional content. id: type: number example: 558449 description: Unique identifier for the movie within the database. imdb_id: type: string example: tt9218128 description: The unique identifier used on IMDb for the movie origin_country: type: array items: type: string example: US example: - US description: >- An array indicating the countries where the movie was produced. original_language: type: string example: en description: The primary language in which the movie was made. original_title: type: string example: Gladiator II description: The original title of the movie as it was first released. overview: type: string example: >- Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people. description: A brief summary of the movie's plot. popularity: type: number example: 5382.147 description: A numerical value indicating the popularity of the movie. poster_path: type: string example: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg description: >- A string that represents the path to the official poster image for the movie. production_companies: type: array items: type: object properties: id: type: number example: 4 description: Unique identifier for the production company. logo_path: type: string nullable: true example: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png description: Path to the company's logo. name: type: string example: Paramount Pictures description: Name of the company. origin_country: type: string example: US description: Country where the company is based. example: - id: 4 logo_path: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png name: Paramount Pictures origin_country: US - id: 221347 logo_path: /6Ry6uNBaa0IbbSs1XYIgX5DkA9r.png name: Scott Free Productions origin_country: US - id: 246486 logo_path: null name: Lucy Fisher/Douglas Wick Productions origin_country: US description: >- An array of objects showing the companies that produced the movie. production_countries: type: array items: type: object properties: iso_3166_1: type: string example: US description: ISO 639-1 code for the language. name: type: string example: United States of America description: >- The country where the production of the movie took place. example: - iso_3166_1: US name: United States of America description: >- An array of objects that denote the countries involved in the film’s production. release_date: type: string example: '2024-11-05' description: The official release date of the movie. revenue: type: number example: 435417355 description: >- The total gross revenue generated by the movie, measured in US dollars (here, $435,417,355). runtime: type: number example: 148 description: The total run time of the movie, expressed in minutes. spoken_languages: type: array items: type: object properties: english_name: type: string example: English description: English name of the language. iso_639_1: type: string example: en description: ISO 639-1 code for the language. name: type: string example: English description: Name of the language in its native form. example: - english_name: English iso_639_1: en name: English description: >- An array of objects representing the languages spoken in the movie. status: type: string example: Released description: The current release status of the movie. tagline: type: string example: Prepare to be entertained. description: >- A brief, catchy phrase or slogan that helps promote the movie. title: type: string example: Gladiator II description: The title of the movie as it is officially known. video: type: boolean example: false description: >- A boolean value indicating whether there is an associated video (such as a trailer) available for the movie. true means there is a video, whereas false indicates there is none. vote_average: type: number example: 6.8 description: >- The average rating that the movie has received from viewers, usually on a scale from 1 to 10. vote_count: type: number example: 1875 description: >- The total number of votes or ratings submitted for the movie. examples: details: value: adult: false backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg belongs_to_collection: backdrop_path: /1VdLvSIeHuwqCT13H9EafxCacGB.jpg id: 1069584 name: Gladiator Collection poster_path: /r7uyUOB6fmmPumWwHiV7Hn2kUbL.jpg budget: 310000000 genres: - id: 28 name: Action - id: 12 name: Adventure - id: 18 name: Drama homepage: https://www.gladiator.movie id: 558449 imdb_id: tt9218128 origin_country: - US original_language: en original_title: Gladiator II overview: >- Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people. popularity: 5382.147 poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg production_companies: - id: 4 logo_path: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png name: Paramount Pictures origin_country: US - id: 221347 logo_path: /6Ry6uNBaa0IbbSs1XYIgX5DkA9r.png name: Scott Free Productions origin_country: US - id: 246486 logo_path: null name: Lucy Fisher/Douglas Wick Productions origin_country: US production_countries: - iso_3166_1: US name: United States of America release_date: '2024-11-05' revenue: 435417355 runtime: 148 spoken_languages: - english_name: English iso_639_1: en name: English status: Released tagline: Prepare to be entertained. title: Gladiator II video: false vote_average: 6.8 vote_count: 1875 components: parameters: append_to_response: name: append_to_response in: query description: >- This add additional data to the response beyond the initial information requested. schema: type: string example: '' language: name: language in: query description: Specifies the language in which the response should be returned. schema: type: string example: en-US movie_id: name: movie_id in: path required: true description: This is a unique identifier for a movie. schema: type: integer example: '' securitySchemes: bearerAuth: type: http scheme: bearer ````