Movie Lists

id

integer

name

string

Create a distributor movie list › Responses

DistributorMovieList was created

id

integer

name

string

POST/distributor-movie-lists

curl https://api.cineamo.com/distributor-movie-lists \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}'

Example Request Body

{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}

json

Example Responses

{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}

json

application/json

Get a distributor movie list

GET

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}

Returns the requested distributor movie list.

Get a distributor movie list › path Parameters

distributorMovieListId

string · required

Get a distributor movie list › Responses

DistributorMovieList details

id

integer

name

string

Delete a distributor movie list

DELETE

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}

Deletes a distributor movie list. Returns an empty response.

Delete a distributor movie list › path Parameters

distributorMovieListId

string · required

Delete a distributor movie list › Responses

DistributorMovieList was deleted

No data returned

Update a distributor movie list

PATCH

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}

Updates a distributor movie list. Returns the updated distributor movie list.

Update a distributor movie list › path Parameters

distributorMovieListId

string · required

Update a distributor movie list › Request Body

id

integer

name

string

Update a distributor movie list › Responses

DistributorMovieList was updated

id

integer

name

string

PATCH/distributor-movie-lists/{distributorMovieListId}

curl https://api.cineamo.com/distributor-movie-lists/:distributorMovieListId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}'

Example Request Body

{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}

json

Example Responses

{
  "id": 0,
  "name": "name",
  "distributor": {
    "id": 1,
    "name": "some cinema name",
    "slug": "some-cinema-name",
    "email": "some@email.com",
    "description": "description",
    "phone": "012345678910",
    "street": "Some Street",
    "postalCode": "12345",
    "city": "Sim City",
    "isActive": "true",
    "isEnabledDefaultConditions": "true",
    "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
    "imageUrl": "imageUrl",
    "imageRef": "00000000-0000-0000-0000-000000000000",
    "countryCode": "DE"
  }
}

json

application/json

Create a distributor movie list item

POST

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items

Creates a distributor movie list item. Returns the created distributor movie list item.

Create a distributor movie list item › path Parameters

distributorMovieListId

string · required

Create a distributor movie list item › Request Body

id

integer

movie

integer

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

Example: 123

Create a distributor movie list item › Responses

DistributorMovieListItem was created

DistributorMovieListItem

id

integer

POST/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items

curl https://api.cineamo.com/distributor-movie-lists/:distributorMovieListId/distributor-movie-list-items \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}'

Example Request Body

{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}

json

Example Responses

{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

Delete a distributor movie list item

DELETE

https://api.cineamo.com

/distributor-movie-list-items/{distributorMovieListItemId}

Deletes a distributor movie list item. Returns an empty response.

Delete a distributor movie list item › path Parameters

distributorMovieListItemId

string · required

Delete a distributor movie list item › Responses

DistributorMovieListItem was deleted

No data returned

List distributor movie list items

GET

https://api.cineamo.com

/distributor-movie-list-items

Returns a list of distributor movie list items objects.

List distributor movie list items › Responses

200

DistributorMovieListItem list

No data returned

Get a distributor movie list item

GET

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items/{distributorMovieListItemId}

Returns the requested distributor movie list item.

Get a distributor movie list item › path Parameters

distributorMovieListId

string · required

distributorMovieListItemId

string · required

Get a distributor movie list item › Responses

DistributorMovieListItem details

DistributorMovieListItem

id

integer

GET/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items/{distributorMovieListItemId}

curl https://api.cineamo.com/distributor-movie-lists/:distributorMovieListId/distributor-movie-list-items/:distributorMovieListItemId

Example Responses

{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

Update a distributor movie list item

PATCH

https://api.cineamo.com

/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items/{distributorMovieListItemId}

Updates a distributor movie list item. Returns the updated distributor movie list item.

Update a distributor movie list item › path Parameters

distributorMovieListId

string · required

distributorMovieListItemId

string · required

Update a distributor movie list item › Request Body

id

integer

movie

integer

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

Example: 123

Update a distributor movie list item › Responses

DistributorMovieListItem was updated

DistributorMovieListItem

id

integer

PATCH/distributor-movie-lists/{distributorMovieListId}/distributor-movie-list-items/{distributorMovieListItemId}

curl https://api.cineamo.com/distributor-movie-lists/:distributorMovieListId/distributor-movie-list-items/:distributorMovieListItemId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}'

Example Request Body

{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}

json

Example Responses

{
  "id": 0,
  "movieList": {
    "id": 0,
    "name": "name",
    "distributor": {
      "id": 1,
      "name": "some cinema name",
      "slug": "some-cinema-name",
      "email": "some@email.com",
      "description": "description",
      "phone": "012345678910",
      "street": "Some Street",
      "postalCode": "12345",
      "city": "Sim City",
      "isActive": "true",
      "isEnabledDefaultConditions": "true",
      "defaultConditionsAlternativeText": "defaultConditionsAlternativeText",
      "imageUrl": "imageUrl",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "countryCode": "DE"
    }
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

List user movie lists

GET

https://api.cineamo.com

/user-movie-lists

Returns a list of user movie lists.

List user movie lists › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

userId

integer

cineamoMovieId

string

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

movieId

integer

Filter lists by the movie id (UserMovieListItem.movie relation). Takes precedence over cineamoMovieId when both are given.

List user movie lists › Responses

200

User movie list

UserMovieList[]

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

Create a user movie list

POST

https://api.cineamo.com

/user-movie-lists

Creates a user movie list. Returns the created user movie list.

Create a user movie list › Request Body

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

Create a user movie list › Responses

UserMovieList was created

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

POST/user-movie-lists

curl https://api.cineamo.com/user-movie-lists \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}'

Example Request Body

{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}

json

Example Responses

{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}

json

application/json

Get a user movie list

GET

https://api.cineamo.com

/user-movie-lists/{userMovieListId}

Returns the requested user movie list.

Get a user movie list › path Parameters

userMovieListId

string · required

Get a user movie list › Responses

UserMovieList details

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

Delete a user movie list

DELETE

https://api.cineamo.com

/user-movie-lists/{userMovieListId}

Deletes a user movie list. Returns an empty response.

Delete a user movie list › path Parameters

userMovieListId

string · required

Delete a user movie list › Responses

UserMovieList was deleted

No data returned

Update a user movie list

PATCH

https://api.cineamo.com

/user-movie-lists/{userMovieListId}

Updates a user movie list. Returns the updated user movie list.

Update a user movie list › path Parameters

userMovieListId

string · required

Update a user movie list › Request Body

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

Update a user movie list › Responses

UserMovieList was updated

readOnly · required

name

string · readOnly · required

id

integer · readOnly · required

PATCH/user-movie-lists/{userMovieListId}

curl https://api.cineamo.com/user-movie-lists/:userMovieListId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}'

Example Request Body

{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}

json

Example Responses

{
  "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"
  },
  "name": "Some User Movie List",
  "id": 10
}

json

application/json

List user movie list items

GET

https://api.cineamo.com

/user-movie-list-items

Returns a list of UserMovieListItem objects.

List user movie list items › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

userMovieListId

integer

cineamoMovieId

string

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

movieId

integer

Filter items by the movie id. Takes precedence over cineamoMovieId when both are given.

List user movie list items › Responses

A list of UserMovieListItem Object

readOnly · required

id

integer · readOnly

readOnly

GET/user-movie-list-items

curl https://api.cineamo.com/user-movie-list-items

Example Responses

{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

Create a user movie list item

POST

https://api.cineamo.com

/user-movie-list-items

Creates a UserMovieListItem. It returns the UserMovieListItem object.

Create a user movie list item › Request Body

readOnly · required

id

integer · readOnly

readOnly

movie

integer

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

Example: 123

Create a user movie list item › Responses

UserMovieListItem was created

readOnly · required

id

integer · readOnly

readOnly

POST/user-movie-list-items

curl https://api.cineamo.com/user-movie-list-items \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}'

Example Request Body

{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}

json

Example Responses

{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

Delete a user movie list item

DELETE

https://api.cineamo.com

/user-movie-list-items/{userMovieListItemId}

Deletes a UserMovieListItem. It returns an empty response.

Delete a user movie list item › path Parameters

userMovieListItemId

string · required

Delete a user movie list item › Responses

UserMovieListItem was deleted

No data returned

Update a user movie list item

PATCH

https://api.cineamo.com

/user-movie-list-items/{userMovieListItemId}

Updates a UserMovieListItem. It returns the updated UserMovieListItem object.

Update a user movie list item › path Parameters

userMovieListItemId

string · required

Update a user movie list item › Request Body

readOnly · required

id

integer · readOnly

readOnly

movie

integer

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

Example: 123

Update a user movie list item › Responses

UserMovieListItem was updated

readOnly · required

id

integer · readOnly

readOnly

PATCH/user-movie-list-items/{userMovieListItemId}

curl https://api.cineamo.com/user-movie-list-items/:userMovieListItemId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}'

Example Request Body

{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  },
  "movie": 123,
  "cineamoMovieId": "cineamoMovieId"
}

json

Example Responses

{
  "id": 1,
  "userMovieList": {
    "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"
    },
    "name": "Some User Movie List",
    "id": 10
  },
  "cineamoMovie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "cineamoId",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "imdbId": "imdbId",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "Some Movie overview",
    "popularity": 0,
    "posterPath": "posterPath",
    "releaseDate": "releaseDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "voteAverage": 0,
    "voteCount": 0,
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "slug": "some-slug"
  }
}

json

application/json

Get a user movie list item

GET

https://api.cineamo.com

/user-movie-list-item/{socialMediaContentId}

Returns a UserMovieListItem object by its Id.

Get a user movie list item › path Parameters

socialMediaContentId

string · required

Get a user movie list item › Responses

UserMovieListItem details