Changes

Get the changes for a movie.

This is a list of all the changes that have been made to a movie. By default, only the last 24 hours are returned. You can query up to 14 days in a single query by using the start_date and end_date query parameters.

tmdb.movies.changes(params: MovieChangesParams): Promise<MovieChanges>;

Parameters

NameTypeRequiredDescription
movie_idnumber✅The ID of the movie.
pagenumber❌Page number of the results to return. Defaults to 1.
start_dateDate❌Optional start date for the changes. Format: YYYY-MM-DD.
end_dateDate❌Optional end date for the changes. Format: YYYY-MM-DD.

Reference:

https://developer.themoviedb.org/reference/movie-changes

Example

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

Types

Response Type

export type MovieChanges = {
  changes: Change[]
};

export type Change = {
	key: string;
	items: ChangeItem[];
};

export type ChangeItem = {
	id: number;
	action: string; // ** Indicates added, updated etc.
	time: string;
	iso_639_1: string;
	iso_3166_1: string;
	value: object;
};

export type MovieChangesParams = {
	movie_id: number;
	page?: number;
	start_date?: string;
	end_date?: string;
};

Example Response

  "changes": [
    {
      "key": "images",
      "items": [
        {
          "id": "685f5393223172b1899154ee",
          "action": "added",
          "time": "2025-06-28 02:29:39 UTC",
          "iso_639_1": "",
          "iso_3166_1": "",
          "value": {
            "poster": {
              "file_path": "/rJaZIkHvjPfrw5TI2isMb4hbgsE.jpg"
            }
          }
        },
        {
          "id": "685f53be2e73b07343228fa5",
          "action": "updated",
          "time": "2025-06-28 02:30:22 UTC",
          "iso_639_1": "en",
          "iso_3166_1": "",
          "value": {
            "poster": {
              "file_path": "/rJaZIkHvjPfrw5TI2isMb4hbgsE.jpg",
              "iso_639_1": "en"
            }
          },
          "original_value": {
            "poster": {
              "file_path": "/rJaZIkHvjPfrw5TI2isMb4hbgsE.jpg",
              "iso_639_1": null
            }
          }
        },
      ]
    }
  ]
}