Copy page

Changelog

Changelog 2026-07-01

Changes

Numeric Movie IDs

Cineamo API endpoints and widgets now expect numeric Movie ids (e.g. 699236) when getting, filtering, creating and updating entities.

For backwards compatibility, the legacy alphanumeric cineamoIds (e.g. 967941m) are still accepted, but they are now considered deprecated, and will be phased out, removing support by 2026-10-01 after a grace period of 3 months.

To update your consumers, refer to a Movie entity by its numeric id property (instead of its alphanumeric cineamoId property) and pass it through the new numeric parameters and properties listed below. When both the numeric and the legacy value are supplied, the numeric one takes precedence.

Reading a single Movie by id

GET endpoints accept both the numeric id and the legacy alphanumeric cineamoId as part of the URL. For example:

Code
-/movies/967941m
+/movies/699236

Filter endpoints — new movieId query parameter

These GET endpoints now accept a numeric movieId query parameter, superseding the deprecated cineamoMovieId parameter. For example:

Code
-/showings?cineamoMovieId=967941m
+/showings?movieId=699236

Affected endpoints:

• GET /showings
• GET /movies
• GET /v2/movies
• GET /contents
• GET /movie-ratings
• GET /movie-copyrights
• GET /event-requests
• GET /user-movie-lists
• GET /user-movie-list-items
• GET /me/movie-lists
• GET /me/movie-ratings
• GET /users/{userId}/movie-ratings
• GET /cinemas/{cinemaId}/movies
• GET /cinemas/{cinemaId}/contents
• GET /cinemas/{cinemaId}/showings-future
• GET /analytics/event-requests-count
• GET /analytics/movie-ratings-average

List responses on these endpoints now also include a numeric movieId field alongside the deprecated cineamoMovieId.

Create/update endpoints — new movie body property

These POST/PATCH endpoints now accept a numeric movie property in the request body, superseding the deprecated cineamoMovieId property. For example:

Code
 {
-  "cineamoMovieId": "967941m"
+  "movie": 699236
 }

Affected endpoints:

• POST /cinema-movie-recommendations
• PATCH /cinema-movie-recommendations/{cinemaMovieRecommendationId}
• POST /distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items
• PATCH /distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items/{distributorMovieListItemId}
• POST /movie-aliases
• PATCH /movie-aliases/{movieAliasId}
• POST /movie-copyrights
• PATCH /movie-copyrights/{movieCopyrightId}
• PATCH /movie-ratings/{movieRatingId}
• PATCH /me/movie-ratings/{cineamoMovieId}
• POST /user-movie-list-items
• PATCH /user-movie-list-items/{userMovieListItemId}

Showtime Finder Widget

The movie parameter of the Showtime Finder Widget accepts both the numeric id and the legacy alphanumeric cineamoId.