> ## Documentation Index > Fetch the complete documentation index at: https://chisa.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. **Append To Response** This method supports using append_to_response. Read more about this here. ## OpenAPI ````yaml api-reference/openapi.json get /3/movie/{{movie_id}} openapi: 3.0.3 info: title: Themoviedb API description: >- Version 3 (stable) of The Movie Database (TMDB) API offers a concise list of available methods for movies, TV shows, actors, and images. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: https://api.themoviedb.org/3 security: [] tags: - name: Account - name: Authentication description: >- # How do I generate a session id? As outlined in the [getting started guide](https://developer.themoviedb.org/docs/getting-started), the basics to getting a user authenticated look like this: 1. **Create a new request token** 2. **Get the user to authorize the request token** 3. **Create a new session id with the authorized request token** Steps 1 and 3 should be fairly easy to understand, but let's walk through each to ensure clarity. ## Step 1: Create a request token The first step as a developer is to request a new token. This is a **temporary token** required to ask the user for permission to access their account. This token will automatically expire **after 60 minutes** if it's not used. ## Step 2: Ask the user for permission With a request token in hand, forward your user to the following URL: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN} ``` You can also pass this URL a `redirect_to` parameter, like so: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved ``` Once the user has approved your request token, they will either be redirected to the URL you specified in the `redirect_to` parameter or to the `/authenticate/allow` path on TMDB. If they aren't redirected to a custom URL, the page will also include an `Authentication-Callback` header. This header contains the API call for step #3. You can either manually generate it or simply use the one we return. ## Step 3: Create a session ID By calling the **new session method** with the request token that has been approved by the user in Step 2, we will return a **new session_id**. This session can now be used to write user data. You should treat this key **like a password** and keep it secret. ## What about guest sessions? A **guest session** can be used to rate movies **without** requiring a registered TMDB user account. For more information about how to create a guest session, see [here](https://developer.themoviedb.org/docs/authentication). - name: Certification - name: Changes - name: Collections - name: Companies - name: Configuration - name: Credits - name: Discover - name: Find - name: Genres - name: Guest Session - name: Keywords - name: List description: >- ## v3 or v4 list? 😕 You may have noticed that the a v4 version of our list API exists. While these v3 list methods continue to work, all of the new features you can see on our website are only available if you switch to the v4 lists. **What are some of the improvements in v4?** - 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 for more information. - name: Movie Lists - name: Movies - name: Networks - name: People Lists - name: People - name: Reviews - name: Search - name: Trending - name: TV Series Lists - name: TV Series - name: TV Seasons - name: TV Episodes - name: TV Episode Groups - name: Watch Providers paths: /3/movie/{{movie_id}}: parameters: - name: movie_id in: path required: true schema: type: string get: tags: - Movies summary: Details description: >- Get the top level details of a movie by ID. **Append To Response** This method supports using append_to_response. Read more about this here. operationId: details6 parameters: - name: language in: query schema: type: string example: en-US responses: '200': description: Details headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=5932 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Tue, 07 Jan 2025 15:31:37 GMT ETag: schema: type: string example: W/"bef6bedf0f386b4b7919883ac433aefc" 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 dd11c9768f8b06d6759fe07ff69421ce.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: IhByUoAq5pDDuDEa8cbb9_wBalY74EzrF0GuUwtv4g-n-YVxS6R8aA== 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: HIT x-memc-age: schema: type: string example: '16644' x-memc-expires: schema: type: string example: '5932' x-memc-key: schema: type: string example: 0aa15dfdb19b41f33a156a34c7df5fef content: application/json: schema: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /zOpe0eHsq0A2NvNyBbtT6sj53qV.jpg belongs_to_collection: type: object properties: backdrop_path: type: string example: /l5CIAdxVhhaUD3DaS4lP4AR2so9.jpg id: type: number example: 720879 name: type: string example: Sonic the Hedgehog Collection poster_path: type: string example: /fwFWhYXj8wY6gFACtecJbg229FI.jpg budget: type: number example: 122000000 genres: type: array items: type: object properties: id: type: number example: 28 name: type: string example: Action example: - id: 28 name: Action - id: 878 name: Science Fiction - id: 35 name: Comedy - id: 10751 name: Family homepage: type: string example: https://www.sonicthehedgehogmovie.com id: type: number example: 939243 imdb_id: type: string example: tt18259086 origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_title: type: string example: Sonic the Hedgehog 3 overview: type: string example: >- Sonic, Knuckles, and Tails reunite against a powerful new adversary, Shadow, a mysterious villain with powers unlike anything they have faced before. With their abilities outmatched in every way, Team Sonic must seek out an unlikely alliance in hopes of stopping Shadow and protecting the planet. popularity: type: number example: 3668.314 poster_path: type: string example: /x7NPbBlrvFRJrpinBSRlMOOUWom.jpg production_companies: type: array items: type: object properties: id: type: number example: 4 logo_path: type: string example: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png name: type: string example: Paramount Pictures origin_country: type: string example: US example: - id: 4 logo_path: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png name: Paramount Pictures origin_country: US - id: 333 logo_path: /5xUJfzPZ8jWJUDzYtIeuPO4qPIa.png name: Original Film origin_country: US - id: 77884 logo_path: /dP2lxVNctD5Cried0IWVqgrO2o9.png name: Marza Animation Planet origin_country: JP - id: 113750 logo_path: /A3QVZ9Ah0yI2d2GiXUFpdlbTgyr.png name: SEGA origin_country: JP - id: 10644 logo_path: /ocLZIdYJBppuCt1rhYEb2jbpt5F.png name: Blur Studio origin_country: US - id: 168701 logo_path: /vWdZFT4V64CCv12D10m44duQjyg.png name: SEGA of America origin_country: US production_countries: type: array items: type: object properties: iso_3166_1: type: string example: JP name: type: string example: Japan example: - iso_3166_1: JP name: Japan - iso_3166_1: US name: United States of America release_date: type: string example: '2024-12-19' revenue: type: number example: 336007876 runtime: type: number example: 110 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 - english_name: Japanese iso_639_1: ja name: 日本語 - english_name: French iso_639_1: fr name: Français - english_name: Spanish iso_639_1: es name: Español status: type: string example: Released tagline: type: string example: New adventure. New rival. title: type: string example: Sonic the Hedgehog 3 video: type: boolean example: false vote_average: type: number example: 7.693 vote_count: type: number example: 368 examples: Details: value: adult: false backdrop_path: /zOpe0eHsq0A2NvNyBbtT6sj53qV.jpg belongs_to_collection: backdrop_path: /l5CIAdxVhhaUD3DaS4lP4AR2so9.jpg id: 720879 name: Sonic the Hedgehog Collection poster_path: /fwFWhYXj8wY6gFACtecJbg229FI.jpg budget: 122000000 genres: - id: 28 name: Action - id: 878 name: Science Fiction - id: 35 name: Comedy - id: 10751 name: Family homepage: https://www.sonicthehedgehogmovie.com id: 939243 imdb_id: tt18259086 origin_country: - US original_language: en original_title: Sonic the Hedgehog 3 overview: >- Sonic, Knuckles, and Tails reunite against a powerful new adversary, Shadow, a mysterious villain with powers unlike anything they have faced before. With their abilities outmatched in every way, Team Sonic must seek out an unlikely alliance in hopes of stopping Shadow and protecting the planet. popularity: 3668.314 poster_path: /x7NPbBlrvFRJrpinBSRlMOOUWom.jpg production_companies: - id: 4 logo_path: /gz66EfNoYPqHTYI4q9UEN4CbHRc.png name: Paramount Pictures origin_country: US - id: 333 logo_path: /5xUJfzPZ8jWJUDzYtIeuPO4qPIa.png name: Original Film origin_country: US - id: 77884 logo_path: /dP2lxVNctD5Cried0IWVqgrO2o9.png name: Marza Animation Planet origin_country: JP - id: 113750 logo_path: /A3QVZ9Ah0yI2d2GiXUFpdlbTgyr.png name: SEGA origin_country: JP - id: 10644 logo_path: /ocLZIdYJBppuCt1rhYEb2jbpt5F.png name: Blur Studio origin_country: US - id: 168701 logo_path: /vWdZFT4V64CCv12D10m44duQjyg.png name: SEGA of America origin_country: US production_countries: - iso_3166_1: JP name: Japan - iso_3166_1: US name: United States of America release_date: '2024-12-19' revenue: 336007876 runtime: 110 spoken_languages: - english_name: English iso_639_1: en name: English - english_name: Japanese iso_639_1: ja name: 日本語 - english_name: French iso_639_1: fr name: Français - english_name: Spanish iso_639_1: es name: Español status: Released tagline: New adventure. New rival. title: Sonic the Hedgehog 3 video: false vote_average: 7.693 vote_count: 368 ````