Movie Ratings

Server

Movie user ratings.

List movie ratings

GET

https://api.cineamo.com

/movie-ratings

Returns a list of movie ratings objects.

List movie ratings › query Parameters

cineamoMovieId

string

Deprecated: use movieId instead (filters by the legacy Cineamo movie id).

movieId

integer

Filter movie-ratings by the movie id (Movie.id). Takes precedence over cineamoMovieId when both are given.

List movie ratings › Responses

200

MovieRating list

No data returned

Create a movie rating

POST

https://api.cineamo.com

/movie-ratings

Creates a movie rating. Returns the created movie rating.

Create a movie rating › Request Body

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

Create a movie rating › Responses

MovieRating was created

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

POST/movie-ratings

curl https://api.cineamo.com/movie-ratings \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7
}'

Example Request Body

{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7
}

json

Example Responses

{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7
}

json

application/json

Get a c movie rating

GET

https://api.cineamo.com

/movie-ratings/{movieRatingId}

Returns the requested c movie rating.

Get a c movie rating › path Parameters

movieRatingId

string · required

Get a c movie rating › Responses

MovieRating details

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

Delete a movie rating ID

DELETE

https://api.cineamo.com

/movie-ratings/{movieRatingId}

Deletes a movie rating ID. Returns an empty response.

Delete a movie rating ID › path Parameters

movieRatingId

string · required

Delete a movie rating ID › Responses

MovieRating was deleted

No data returned

Update a movie rating

PATCH

https://api.cineamo.com

/movie-ratings/{movieRatingId}

Updates a movie rating. Returns the updated movie rating.

Update a movie rating › path Parameters

movieRatingId

string · required

Update a movie rating › Request Body

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

movie

integer

The movie id. Takes precedence over cineamoMovieId when both are given.

Example: 123

Update a movie rating › Responses

200

MovieRating was updated

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

PATCH/movie-ratings/{movieRatingId}

curl https://api.cineamo.com/movie-ratings/:movieRatingId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7,
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}'

Example Request Body

{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7,
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}

json

Example Responses

{
  "id": 1,
  "movieId": 123,
  "rating": 8,
  "user": {
    "id": 123,
    "username": "i_am_batman",
    "firstName": "Frank",
    "lastName": "Pentangeli",
    "profileImageRef": "00000000-0000-0000-0000-000000000000",
    "profileImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/user-profile",
    "isActivated": true,
    "isDeleted": "true",
    "lastAccessTokenDatetime": "2022-04-11T04:11:22Z"
  },
  "headline": "A masterpiece",
  "text": "Loved every minute of it.",
  "isSpoiler": false,
  "createdDatetime": "2024-06-01T12:00:00Z",
  "cinemaExperienceScore": 7
}

json

application/json

Movie Customizations Movie Trailers

List movie ratings

GET

https://api.cineamo.com

/movie-ratings

Returns a list of movie ratings objects.

List movie ratings › query Parameters

cineamoMovieId

string

Deprecated: use movieId instead (filters by the legacy Cineamo movie id).

movieId

integer

Filter movie-ratings by the movie id (Movie.id). Takes precedence over cineamoMovieId when both are given.

List movie ratings › Responses

200

MovieRating list

No data returned

Create a movie rating

POST

https://api.cineamo.com

/movie-ratings

Creates a movie rating. Returns the created movie rating.

Create a movie rating › Request Body

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

Create a movie rating › Responses

MovieRating was created

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

Get a c movie rating

GET

https://api.cineamo.com

/movie-ratings/{movieRatingId}

Returns the requested c movie rating.

Get a c movie rating › path Parameters

movieRatingId

string · required

Get a c movie rating › Responses

MovieRating details

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

Update a movie rating

PATCH

https://api.cineamo.com

/movie-ratings/{movieRatingId}

Updates a movie rating. Returns the updated movie rating.

Update a movie rating › path Parameters

movieRatingId

string · required

Update a movie rating › Request Body

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7

movie

integer

The movie id. Takes precedence over cineamoMovieId when both are given.

Example: 123

Update a movie rating › Responses

200

MovieRating was updated

MovieRating

rating

integer · readOnly · required

isSpoiler

boolean · readOnly · required

True when the review reveals plot details. Consumers can hide these by default.

Example: false

id

integer | null · readOnly

movieId

integer | null · readOnly

CinApi\User\Dto\UserDtoInterface | null · readOnly

headline

string | null · readOnly

text

string | null · readOnly

createdDatetime

string | null · readOnly

cinemaExperienceScore

integer | null · readOnly

How well the movie performed on a big cinema screen (1–10).

Example: 7