> ## Documentation Index > Fetch the complete documentation index at: https://iqma-31aad55c.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Details > This endpoint is used to get the top level details of a movie by ID. ## OpenAPI ````yaml api-reference/TMDB.json get /3/movie/{movie_id} openapi: 3.0.3 info: title: The Movie Database description: "# About\n\nThe Movie Database (TMDB) is a _community built_ movie and TV database. Every piece of data has been added by our amazing community dating back to 2008. TMDB's strong _international focus_ and breadth of data is largely unmatched and something we're incredibly proud of\n\nAlong with extensive metadata for movies, TV shows and people, we also offer one of the best selections of high resolution posters and backdrops. On average, over 1,000 images are added every single day.\n\n# Getting Started\n\nWelcome to version 3 (v3) of Ihe Movie Database(TMDB)API. This documentation serves as a guide to kick- start your experience with the world's largest movie database,\_Operating under the REST architecture. this API has become familiar to developers over the years, owing to its resemblance to the well-known web request and response pattern and its utillization of JSON as the preferred syntax for delivering responses.\n\nHere, you'll find information on all your favorite movies, including ratings, release dates, and much more. However, before you begin, be sure to explore the introductory pages, which include the Authentication page and the Errors & status code page.\_\n\n# Authentication \n\nBefore you can use the TMBD API, you need to generate your API Key - which is how you authenticate with the API.\nTo get an API key, you need to sign up at the officlal TMDB homepage. To do sign up, follow the steps below\_\n\n1. Navigate to the TMBD sign up page.\n\n2. After submitting your requested details, verify your account to login.\n3. Once you are logged in, you can now access your profile page containing information such as your most watched genres, and other recent activities.\n4. At the right corner of your profile page, navigate to your profile avatar and select the Settings options.\n5. On the settings page, navigate to the API option at the left corner menu.\n6. From the following options, chose the plan that suits you, The options include Developer and Professional. Both plans have their advantages listed below them.\n7.\_Once you select a plan, you'll fill out the form which would collect information about the API usage. information requested would include name of applicaton, it's url, etc.\n8. Once completed, you would be redirected to a new page where you'll see your generated API Key, Or check the notification icon for an instant message delivering your API key with additional informatian on the next steps to take." version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - apikey: [] tags: - name: Getting Started - name: Account description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Authentication description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Certifications - name: Changes - name: Collections description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Companies - name: Configuration - name: Credits description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Discover - name: Find description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Genres - name: Keywords description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movie Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movies description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Networks description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: People Lists - name: People description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Reviews description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Search - name: Trending - name: TV Series Lists - name: TV Series description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: TV Seasons - name: TV Episodes - name: TV Episode Groups description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Watch Provider paths: /3/movie/{movie_id}: get: tags: - Movies summary: Details description: This endpoint is used to get the top level details of a movie by ID. operationId: details7 parameters: - name: movie_id in: path required: true schema: type: string example: '1241982' description: integer responses: '200': description: OK headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=25392 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Tue, 17 Dec 2024 15:03:09 GMT ETag: schema: type: string example: W/"7bb5647850919080588604fd826c3876" 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 738984066968793a5714282f49fe0ab8.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: w9Z9ipgCd9C174SYO9SMQOxBW0HOrZI_OtR2xfiAgYU4P6TsbaXIrg== 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: '1487' x-memc-expires: schema: type: string example: '25392' x-memc-key: schema: type: string example: 46482bc017e1cd2b57f379de6cef8bdf content: application/json: schema: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /tElnmtQ6yz1PjN1kePNl8yMSb59.jpg belongs_to_collection: type: object properties: backdrop_path: type: string example: /4OgaftFNqtE1UvfDDb2Eov7A5Rz.jpg id: type: number example: 1241984 name: type: string example: Moana Collection poster_path: type: string example: /hiGRhPYMKU8aXfxmSD7lqJNSzJG.jpg budget: type: number example: 150000000 genres: type: array items: type: object properties: id: type: number example: 16 name: type: string example: Animation example: - id: 16 name: Animation - id: 12 name: Adventure - id: 10751 name: Family - id: 35 name: Comedy homepage: type: string example: https://movies.disney.com/moana-2 id: type: number example: 1241982 imdb_id: type: string example: tt13622970 origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_title: type: string example: Moana 2 overview: type: string example: >- After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced. popularity: type: number example: 3274.354 poster_path: type: string example: /4YZpsylmjHbqeWzjKpUEF8gcLNW.jpg production_companies: type: array items: type: object properties: id: type: number example: 2 logo_path: type: string example: /wdrCwmRnLFJhEoH8GSfymY85KHT.png name: type: string example: Walt Disney Pictures origin_country: type: string example: US example: - id: 2 logo_path: /wdrCwmRnLFJhEoH8GSfymY85KHT.png name: Walt Disney Pictures origin_country: US - id: 6125 logo_path: /tzsMJBJZINu7GHzrpYzpReWhh66.png name: Walt Disney Animation Studios origin_country: US - id: 158526 logo_path: /tzsMJBJZINu7GHzrpYzpReWhh66.png name: Walt Disney Animation Studios origin_country: CA production_countries: type: array items: type: object properties: iso_3166_1: type: string example: CA name: type: string example: Canada example: - iso_3166_1: CA name: Canada - iso_3166_1: US name: United States of America release_date: type: string example: '2024-11-21' revenue: type: number example: 717016469 runtime: type: number example: 100 spoken_languages: type: array items: type: object properties: english_name: type: string example: English iso_639_1: type: string example: en name: type: string example: English example: - english_name: English iso_639_1: en name: English status: type: string example: Released tagline: type: string example: The ocean is calling them back. title: type: string example: Moana 2 video: type: boolean example: false vote_average: type: number example: 6.942 vote_count: type: number example: 506 examples: OK: value: adult: false backdrop_path: /tElnmtQ6yz1PjN1kePNl8yMSb59.jpg belongs_to_collection: backdrop_path: /4OgaftFNqtE1UvfDDb2Eov7A5Rz.jpg id: 1241984 name: Moana Collection poster_path: /hiGRhPYMKU8aXfxmSD7lqJNSzJG.jpg budget: 150000000 genres: - id: 16 name: Animation - id: 12 name: Adventure - id: 10751 name: Family - id: 35 name: Comedy homepage: https://movies.disney.com/moana-2 id: 1241982 imdb_id: tt13622970 origin_country: - US original_language: en original_title: Moana 2 overview: >- After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced. popularity: 3274.354 poster_path: /4YZpsylmjHbqeWzjKpUEF8gcLNW.jpg production_companies: - id: 2 logo_path: /wdrCwmRnLFJhEoH8GSfymY85KHT.png name: Walt Disney Pictures origin_country: US - id: 6125 logo_path: /tzsMJBJZINu7GHzrpYzpReWhh66.png name: Walt Disney Animation Studios origin_country: US - id: 158526 logo_path: /tzsMJBJZINu7GHzrpYzpReWhh66.png name: Walt Disney Animation Studios origin_country: CA production_countries: - iso_3166_1: CA name: Canada - iso_3166_1: US name: United States of America release_date: '2024-11-21' revenue: 717016469 runtime: 100 spoken_languages: - english_name: English iso_639_1: en name: English status: Released tagline: The ocean is calling them back. title: Moana 2 video: false vote_average: 6.942 vote_count: 506 components: securitySchemes: apikey: type: apiKey name: '{{key}}' in: query ````