> ## 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.

# Get movie details

> This endpoint is used to get the details of a movie by its ID.



## OpenAPI

````yaml api-reference/openapi.yaml get /3/movie/{movie_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/movie/{movie_id}:
    get:
      tags:
        - Movies
      summary: Get movie details
      description: This endpoint is used to get the details of a movie by its ID.
      operationId: getMovieDetails
      parameters:
        - $ref: '#/components/parameters/movieId'
        - $ref: '#/components/parameters/appendToResponse'
        - $ref: '#/components/parameters/language'
      responses:
        '200':
          description: Request successful
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=17969
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Wed, 01 Jan 2025 22:24:15 GMT
            ETag:
              schema:
                type: string
                example: W/"d770a21f483237a93d072914fe5816b0"
            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 20b61f8a897671342027285e75830e4e.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: _io7JteXsqJFtwZ_A0_eKEXI18hgcuuBofQXDG4dXNkIXUm56xP8vA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: CDG50-C1
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '4720'
            x-memc-expires:
              schema:
                type: string
                example: '17969'
            x-memc-key:
              schema:
                type: string
                example: 50de8a0bf01bd1fa5e03255dea67c44e
          content:
            application/json:
              schema:
                type: object
                properties:
                  adult:
                    type: boolean
                    example: false
                  backdrop_path:
                    type: string
                    example: /wgvc3PmjQGtYYDWaeuV867mnFDs.jpg
                  belongs_to_collection:
                    nullable: true
                    example: null
                  budget:
                    type: number
                    example: 90000000
                  genres:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          example: 878
                        name:
                          type: string
                          example: Science Fiction
                    example:
                      - id: 878
                        name: Science Fiction
                      - id: 28
                        name: Action
                      - id: 12
                        name: Adventure
                  homepage:
                    type: string
                    example: https://www.sonypictures.com/movies/thefifthelement
                  id:
                    type: number
                    example: 18
                  imdb_id:
                    type: string
                    example: tt0119116
                  origin_country:
                    type: array
                    items:
                      type: string
                      example: FR
                    example:
                      - FR
                  original_language:
                    type: string
                    example: fr
                  original_title:
                    type: string
                    example: Le Cinquième Élément
                  overview:
                    type: string
                    example: >-
                      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:
                    type: number
                    example: 65.447
                  poster_path:
                    type: string
                    example: /fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg
                  production_companies:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          example: 9
                        logo_path:
                          type: string
                          example: /nda3dTUYdDrJ6rZqBpYvY865aDv.png
                        name:
                          type: string
                          example: Gaumont
                        origin_country:
                          type: string
                          example: FR
                    example:
                      - id: 9
                        logo_path: /nda3dTUYdDrJ6rZqBpYvY865aDv.png
                        name: Gaumont
                        origin_country: FR
                  production_countries:
                    type: array
                    items:
                      type: object
                      properties:
                        iso_3166_1:
                          type: string
                          example: FR
                        name:
                          type: string
                          example: France
                    example:
                      - iso_3166_1: FR
                        name: France
                  release_date:
                    type: string
                    example: '1997-05-02'
                  revenue:
                    type: number
                    example: 263920180
                  runtime:
                    type: number
                    example: 126
                  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: Swedish
                        iso_639_1: sv
                        name: svenska
                      - english_name: German
                        iso_639_1: de
                        name: Deutsch
                  status:
                    type: string
                    example: Released
                  tagline:
                    type: string
                    example: There is no future without it.
                  title:
                    type: string
                    example: The Fifth Element
                  video:
                    type: boolean
                    example: false
                  vote_average:
                    type: number
                    example: 7.553
                  vote_count:
                    type: number
                    example: 10757
              examples:
                Example response:
                  value:
                    adult: false
                    backdrop_path: /wgvc3PmjQGtYYDWaeuV867mnFDs.jpg
                    belongs_to_collection: null
                    budget: 90000000
                    genres:
                      - id: 878
                        name: Science Fiction
                      - id: 28
                        name: Action
                      - id: 12
                        name: Adventure
                    homepage: https://www.sonypictures.com/movies/thefifthelement
                    id: 18
                    imdb_id: tt0119116
                    origin_country:
                      - FR
                    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
                    production_companies:
                      - id: 9
                        logo_path: /nda3dTUYdDrJ6rZqBpYvY865aDv.png
                        name: Gaumont
                        origin_country: FR
                    production_countries:
                      - iso_3166_1: FR
                        name: France
                    release_date: '1997-05-02'
                    revenue: 263920180
                    runtime: 126
                    spoken_languages:
                      - english_name: English
                        iso_639_1: en
                        name: English
                      - english_name: Swedish
                        iso_639_1: sv
                        name: svenska
                      - english_name: German
                        iso_639_1: de
                        name: Deutsch
                    status: Released
                    tagline: There is no future without it.
                    title: The Fifth Element
                    video: false
                    vote_average: 7.553
                    vote_count: 10757
components:
  parameters:
    movieId:
      in: path
      name: movie_id
      required: true
      schema:
        type: integer
        example: 18
      description: A unique identifier for a movie
    appendToResponse:
      in: query
      name: append_to_response
      schema:
        type: string
        example: collections
      description: A comma separated list of endpoints within this namespace, 20 items max.
    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.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````