Release Dates

Get the release dates and certifications for a movie. For different countries and release types.

The release types and statuses used on TMDB are the following:

TypeDescription
1Premiere
2Theatrical (Limited)
3Theatrical
4Digital
5Physical
6TV
tmdb.movies.release_dates(params: MovieReleaseDatesParams): Promise<MovieReleaseDates>;

Parameters

NameTypeRequiredDescription
movie_idnumber✅The ID of the movie.

Reference:

https://developer.themoviedb.org/reference/movie-release-dates

Example

const result = await tmdb.movie.release_dates({ movie_id: 550 });

Types

Response Type

export type MovieReleaseDates = {
	id: number;
	results: MovieReleaseDateResult[];
};

export type MovieReleaseDateResult = {
	iso_3166_1: string;
	release_dates: MovieReleaseDate[];
};

export type MovieReleaseDate = {
	certification: string;
	iso_639_1: string;
	release_date: string;
	type: ReleaseType | number;
	note: string;
	descriptors: unknown[];
};

export type MovieReleaseDatesParams = {
  movie_id: number;
}

Example Response

{
  "id": 550,
  "results": [
    {
      "iso_3166_1": "AE",
      "release_dates": [
        {
          "certification": "",
          "descriptors": [],
          "iso_639_1": "",
          "note": "Blu-ray",
          "release_date": "2009-11-23T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "AR",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-04T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    ...
  ]
}