---
title: "Get Changes"
method: GET
path: "/changes"
tags: ["changes"]
---

# Get Changes

`GET /changes`

Query the new, removed, updated, expiring or upcoming movies/series/seasons/episodes in a given list of streaming services.
Results are ordered by the date of the changes.
Changes listed per page is 25.

Changes are listed under changes field, and shows affected by these changes are listed under shows field.

Note that upcoming changes are only supported for Apple TV, Disney+, Max, Netflix and Prime Video.
For other services, upcoming changes will return an empty list.

## Query parameters

- `country` string, required
- `catalogs` string[]
- `change_type` 'new' | 'removed' | 'updated' | 'expiring' | 'upcoming', required — Type of the change.
- `item_type` 'show' | 'season' | 'episode', required — Type of an item.
- `show_type` 'movie' | 'series' — Type of a show.
- `from` integer
- `to` integer
- `include_unknown_dates` boolean
- `cursor` string
- `order_direction` 'asc' | 'desc'
- `output_language` 'en' | 'es' | 'tr' | 'fr'

## Response `200`

Response to a change set query.

- ChangesResult
  - `changes` Change[], required — Array of the changes.
    - `changeType` 'new' | 'removed' | 'updated' | 'expiring' | 'upcoming', required — Type of the change.
    - `itemType` 'show' | 'season' | 'episode', required — Type of an item.
    - `showId` string, required — Id of the show affected from the change.
    - `showType` 'movie' | 'series', required — Type of a show.
    - `season` integer — Number of the season affected from the change. Omitted if item_type is not seasonor episode.
    - `episode` integer — Number of the episode affected from the change. Omitted if item_type is not episode.
    - `service` ServiceInfo, required — Details of the streaming service localized according to the parent country.
      - `id` string, required — Id of the service.
      - `name` string, required — Name of the service.
      - `homePage` string, required — Link to the homepage of the service.
      - `themeColorCode` string, required — Associated theme color hex code of the service.
      - `imageSet` ServiceImageSet, required — Image set of a service or an addon.
        - `lightThemeImage` string, required — Link to the logo suitable for light themed background.
        - `darkThemeImage` string, required — Link to the logo suitable for dark themed background.
        - `whiteImage` string, required — Link to the logo that is all white.
    - `streamingOptionType` 'free' | 'subscription' | 'buy' | 'rent' | 'addon', required — Type of the streaming option.
    - `addon` Addon — Details of an addon.
      - `id` string, required — Id of the addon.
      - `name` string, required — Name of the addon.
      - `homePage` string, required — Link to the homepage of the addon.
      - `themeColorCode` string, required — Associated theme color hex code of the addon.
      - `imageSet` ServiceImageSet, required — Image set of a service or an addon.
        - `lightThemeImage` string, required — Link to the logo suitable for light themed background.
        - `darkThemeImage` string, required — Link to the logo suitable for dark themed background.
        - `whiteImage` string, required — Link to the logo that is all white.
    - `timestamp` integer — [Unix Time Stamp](https://www.unixtimestamp.com/) of the change. Past changes (new, updated, removed) will always have a timestamp. Future changes (expiring, upcoming) will have a timestamp if the exact date is known. If not, timestamp will be omitted, e.g. a show is known to be expiring soon, but the exact date is not known.
    - `link` string — Deep link to the affected streaming option's page in the web app of the streaming service. This field is guaranteed to be populated when changeType is new, updated, expiring or removed. When changeType is upcoming, this field might be populated or null depending on if the link of the future streaming option is known.
  - `shows` ShowMap, required — Map of the shows by their ids.
  - `hasMore` boolean, required — Whether there are more changes available.
  - `nextCursor` string — Cursor value to pass to get the next set of changes.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/myangel-ai/apis/streaming-availability-api.md) · [All operations](https://skmtc.net/myangel-ai/apis/streaming-availability-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myangel-ai/streaming-availability-api/revisions/16fa35a29f15/schema)