Cinemas

A cinema refers to a complex in one geographic location where films are shown. Each cinema has one or more screens.

Cinema

A cinema refers to a complex in one geographic location where films are shown.

cinema_id required	string (Cinema_id) Each `cinema` has a unique `cinema_id` which is used as an identifier in different parts of the Movio API.
name required	string The `cinema` must have a name. This name is how the `cinema` will be displayed within Movio EQ. It is often how the `cinema` is commonly known to the exhibitor.
timezone required	string The `cinema` must also have a timezone which is the timezone of the area where the `cinema` is geographically located. This field is important as it impacts various dates within Movio EQ and may affect when a member is contacted in Movio EQ campaigns. The timezone must be an IANA recognized timezone. For a list of recognized timezones please see Timezones.
tags	Array of strings (Tags) <= 10 items A list of tags that are used to group items together.

{"cinema_id": "northcitymultiplex01",
"name": "North City Multiplex",
"timezone": "Pacific/Auckland",
"tags": ["IMAX",
"3D"
]
}

Create / Update Cinemas

Creates or updates a cinema in the system. This will create the cinema in Movio if the Cinema does not exist. If the cinema exists, then the cinema with the same cinema_id will be one to one replaced with the new cinema.

SecurityOAuth2

Request

Request Body schema: application/json
required

The cinemas to be created.

Array ([ 1 .. 5000 ] items)

cinema_id required	string (Cinema_id) Each `cinema` has a unique `cinema_id` which is used as an identifier in different parts of the Movio API.
name required	string The `cinema` must have a name. This name is how the `cinema` will be displayed within Movio EQ. It is often how the `cinema` is commonly known to the exhibitor.
timezone required	string The `cinema` must also have a timezone which is the timezone of the area where the `cinema` is geographically located. This field is important as it impacts various dates within Movio EQ and may affect when a member is contacted in Movio EQ campaigns. The timezone must be an IANA recognized timezone. For a list of recognized timezones please see Timezones.
tags	Array of strings (Tags) <= 10 items A list of tags that are used to group items together.

Responses

202

The response to a bulk request that succeeded.

400

The response to a bulk request that failed.

401

The request has not been applied because it lacks valid authentication credentials for the target resource.

422

The request was well-formed but was unable to be followed due to semantic errors.

put/cinemas

Request samples

Payload

application/json

[{"cinema_id": "northcitymultiplex01",
"name": "North City Multiplex",
"timezone": "Pacific/Auckland",
"tags": ["IMAX",
"3D"
]
}
]

Response samples

application/json

{"total": 3,
"created_count": 2,
"updated_count": 1
}

Delete Cinema

Deletes a cinema from the system. This effectively remove the cinema from Movio. Useful when a cinema has closed down and is no longer operating. Movio will keep the cinema in the system for historical purposes.

SecurityOAuth2

Request

path Parameters

cinema_id

required

string (Cinema_id)

The unique identifier for a cinema.

Example: northcitymultiplex01

Responses

204

The cinema was deleted successfully.

400

The request could not be understood by the server due to malformed syntax.

401

The request has not been applied because it lacks valid authentication credentials for the target resource.

422

The request was well-formed but was unable to be followed due to semantic errors.

delete/cinemas/{cinema_id}