---
title: "Get Title Release Dates - Advanced"
method: GET
path: "/title-release-dates"
tags: ["Releases"]
---

# Get Title Release Dates - Advanced

`GET /title-release-dates`

Get streaming and theatrical release dates for titles within a specified date range.
Includes both historical and upcoming releases, as well as streaming premieres and theatrical releases.

Release dates are returned as normalized calendar dates in `YYYY-MM-DD` format. When an upstream source provides a midnight UTC
availability timestamp that is stored in a US time zone, Watchmode normalizes it back to the intended UTC calendar date before
filtering and returning results.

By default, this endpoint returns all region-specific release rows available to Watchmode. Use the `regions` parameter to filter
results to specific countries. Some legacy streaming release-date sources are US-only; those rows are returned with `region: "US"`.

Outside the US, theatrical rows are materialized for `data_tier: 1` regions from movie release events explicitly classified as
limited theatrical or theatrical by the upstream source. Digital, physical-media, television, festival, and premiere-only events
are not returned as theatrical releases. US theatrical rows continue to use Watchmode's legacy theatrical calendar source.

**Note:** This endpoint requires a paid plan.

## Query parameters

- `start_date` integer
- `end_date` integer
- `regions` string

## Response `200`

List of upcoming release dates

- TitleReleaseDate[]
  - `id` integer
  - `title` string
  - `title_type` 'movie' | 'tv_series' | 'tv_special' | 'tv_miniseries' | 'short_film' | 'tv_movie'
  - `original_language` string, nullable — Original language code for the matched Watchmode title when available.
  - `region` string
  - `type` 'streaming_movie_release' | 'streaming_tv_season_release' | 'theatrical_release'
  - `release_date` string, date
  - `provider_id` integer, nullable — Streaming provider ID (null for theatrical)
  - `season` integer, nullable — Season number (for TV releases)

## Other responses

- `401` — Unauthorized or free plan

---

[API](https://skmtc.dev/watchmode/apis/watchmode-api.md) · [All operations](https://skmtc.dev/watchmode/apis/watchmode-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/watchmode/watchmode-api/revisions/3215d2b959fa/schema)