---
title: "Upcoming"
method: GET
path: "/3/movie/upcoming"
---

# Upcoming

`GET /3/movie/upcoming`

## Request

- Base URL: `https://api.themoviedb.org`
- URL: `https://api.themoviedb.org/3/movie/upcoming`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/themoviedb/apis/tmdb-api/docs/3/movie/upcoming/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of movies that are being released soon.

## Query parameters

- `language` string
- `page` integer
- `region` string

## Response `200`

200

- object
  - `dates` object
    - `maximum` string
    - `minimum` string
  - `page` integer
  - `results` object[]
    - `adult` boolean
    - `backdrop_path` string
    - `genre_ids` integer[]
    - `id` integer
    - `original_language` string
    - `original_title` string
    - `overview` string
    - `popularity` number
    - `poster_path` string
    - `release_date` string
    - `title` string
    - `video` boolean
    - `vote_average` integer
    - `vote_count` integer
  - `total_pages` integer
  - `total_results` integer

## Changes

- **2026-11-03** `1c709375fe99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/themoviedb/apis/tmdb-api/changes/3/movie/upcoming/get.md)

---

[API](https://skmtc.dev/themoviedb/apis/tmdb-api.md) - [All operations](https://skmtc.dev/themoviedb/apis/tmdb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/themoviedb/apis/tmdb-api/revisions/1c709375fe99?raw)