> ## Documentation Index
> Fetch the complete documentation index at: https://ileolami.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Upcoming

> This endpoint get upcoming movies with a specific language, page, and region.



## OpenAPI

````yaml get /3/movie/upcoming
openapi: 3.0.3
info:
  title: The Movie Database
  description: Reference
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: ACCOUNT
  - name: AUTHENTICATION
  - name: CERTIFICATION
  - name: CHANGES
  - name: COLLECTION
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSION
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORK
  - name: PEOPLE
  - name: PEOPLE LISTS
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODES GROUPS
  - name: WATCH PROVIDERS
paths:
  /3/movie/upcoming:
    get:
      tags:
        - MOVIE LISTS
      summary: Upcoming
      description: >-
        This endpoint get upcoming movies with a specific language, page, and
        region.
      operationId: upcoming
      parameters:
        - name: language
          in: query
          schema:
            type: string
            default: en-US
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: region
          in: query
          schema:
            type: string
            example: NG
          description: ISO-3166-1 code
      responses:
        '200':
          description: Upcoming
          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: Mon, 30 Dec 2024 09:36:38 GMT
            ETag:
              schema:
                type: string
                example: W/"dec48ec141f512be50196c108b692d6b"
            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 7df0e12cb5a55cb5e64296e91e226fbe.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: jvwpbMXzzPoyBAC_a9feTMZgbOnOaRAz1GYDIdOlIYuRCxxQwOVktA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-P2
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
          content:
            application/json:
              schema:
                type: object
                properties:
                  dates:
                    type: object
                    properties:
                      maximum:
                        type: string
                        example: '2025-02-19'
                      minimum:
                        type: string
                        example: '2025-01-29'
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          example: false
                        backdrop_path:
                          type: string
                          example: /5PxK2PeDdUaq0557CuBt57WNIKC.jpg
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 35
                          example:
                            - 35
                            - 27
                        id:
                          type: number
                          example: 1310558
                        original_language:
                          type: string
                          example: he
                        original_title:
                          type: string
                          example: השותף
                        overview:
                          type: string
                          example: >-
                            Dooby (a vampire) and Micha (a werewolf) are
                            roommates and live in a small apartment with a great
                            legacy. One day, they find out about the concept of
                            bills, and for the first time ever, decide to add a
                            human roommate. Since then, things only get crazier.
                        popularity:
                          type: number
                          example: 0.405
                        poster_path:
                          type: string
                          example: /t7N26CMuATjHN5VHQ32XjRaOSZt.jpg
                        release_date:
                          type: string
                          example: '2025-02-05'
                        title:
                          type: string
                          example: PayDay
                        video:
                          type: boolean
                          example: false
                        vote_average:
                          type: number
                          example: 0
                        vote_count:
                          type: number
                          example: 0
                    example:
                      - adult: false
                        backdrop_path: /5PxK2PeDdUaq0557CuBt57WNIKC.jpg
                        genre_ids:
                          - 35
                          - 27
                        id: 1310558
                        original_language: he
                        original_title: השותף
                        overview: >-
                          Dooby (a vampire) and Micha (a werewolf) are roommates
                          and live in a small apartment with a great legacy. One
                          day, they find out about the concept of bills, and for
                          the first time ever, decide to add a human roommate.
                          Since then, things only get crazier.
                        popularity: 0.405
                        poster_path: /t7N26CMuATjHN5VHQ32XjRaOSZt.jpg
                        release_date: '2025-02-05'
                        title: PayDay
                        video: false
                        vote_average: 0
                        vote_count: 0
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 1
              examples:
                Upcoming:
                  value:
                    dates:
                      maximum: '2025-02-19'
                      minimum: '2025-01-29'
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /5PxK2PeDdUaq0557CuBt57WNIKC.jpg
                        genre_ids:
                          - 35
                          - 27
                        id: 1310558
                        original_language: he
                        original_title: השותף
                        overview: >-
                          Dooby (a vampire) and Micha (a werewolf) are roommates
                          and live in a small apartment with a great legacy. One
                          day, they find out about the concept of bills, and for
                          the first time ever, decide to add a human roommate.
                          Since then, things only get crazier.
                        popularity: 0.405
                        poster_path: /t7N26CMuATjHN5VHQ32XjRaOSZt.jpg
                        release_date: '2025-02-05'
                        title: PayDay
                        video: false
                        vote_average: 0
                        vote_count: 0
                    total_pages: 1
                    total_results: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````