Movie Tours

Server

Touring-movie programmes and stops.

List movie tours

GET

https://api.cineamo.com

/movie-tours

Returns a list of MovieTour objects.

List movie tours › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

movieIds

integer[]

List movie tours › Responses

MovieTour list

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

Create a movie tour

POST

https://api.cineamo.com

/movie-tours

Creates a MovieTour. It returns the MovieTour object.

Create a movie tour › Request Body

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

Create a movie tour › Responses

MovieTour was created

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

Get a movie tour

GET

https://api.cineamo.com

/movie-tours/{movieTourId}

Returns a MovieTour object by its Id.

Get a movie tour › path Parameters

movieTourId

integer · required

Get a movie tour › Responses

MovieTour details

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

Delete a movie tour

DELETE

https://api.cineamo.com

/movie-tours/{movieTourId}

Deletes a MovieTour. It returns an empty response.

Delete a movie tour › path Parameters

movieTourId

string · required

Delete a movie tour › Responses

MovieTour was deleted

No data returned

Update a movie tour

PATCH

https://api.cineamo.com

/movie-tours/{movieTourId}

Updates a MovieTour. It returns the updated MovieTour object.

Update a movie tour › path Parameters

movieTourId

integer · required

Update a movie tour › Request Body

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

Update a movie tour › Responses

200

MovieTour was updated

MovieTour

id

integer · readOnly

title

string · readOnly

description

string | null · readOnly

movieId

integer · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

PATCH/movie-tours/{movieTourId}

curl https://api.cineamo.com/movie-tours/:movieTourId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "title": "Summer Tour",
  "description": "A summer movie tour",
  "movieId": 42,
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z"
}'

Example Request Body

{
  "id": 1,
  "title": "Summer Tour",
  "description": "A summer movie tour",
  "movieId": 42,
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z"
}

json

Example Responses

{
  "id": 1,
  "title": "Summer Tour",
  "description": "A summer movie tour",
  "movieId": 42,
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z"
}

json

application/json

List movie tour stops

GET

https://api.cineamo.com

/movie-tour-stops

Returns a list of MovieTourStop objects.

List movie tour stops › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

movieTourIds

integer[]

cinemaIds

integer[]

cityIds

integer[]

showingIds

integer[]

iso31661s

string[]

startDatetimeStart

string

startDatetimeEnd

string

List movie tour stops › Responses

MovieTourStop list

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

Create a movie tour stop

POST

https://api.cineamo.com

/movie-tour-stops

Creates a MovieTourStop. It returns the MovieTourStop object.

Create a movie tour stop › Request Body

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

Create a movie tour stop › Responses

MovieTourStop was created

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

POST/movie-tour-stops

curl https://api.cineamo.com/movie-tour-stops \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}'

Example Request Body

{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}

json

Example Responses

{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}

json

application/json

Get a movie tour stop

GET

https://api.cineamo.com

/movie-tour-stops/{movieTourStopId}

Returns a MovieTourStop object by its Id.

Get a movie tour stop › path Parameters

movieTourStopId

integer · required

Get a movie tour stop › Responses

MovieTourStop details

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

Delete a movie tour stop

DELETE

https://api.cineamo.com

/movie-tour-stops/{movieTourStopId}

Deletes a MovieTourStop. It returns an empty response.

Delete a movie tour stop › path Parameters

movieTourStopId

string · required

Delete a movie tour stop › Responses

MovieTourStop was deleted

No data returned

Update a movie tour stop

PATCH

https://api.cineamo.com

/movie-tour-stops/{movieTourStopId}

Updates a MovieTourStop. It returns the updated MovieTourStop object.

Update a movie tour stop › path Parameters

movieTourStopId

integer · required

Update a movie tour stop › Request Body

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

Update a movie tour stop › Responses

200

MovieTourStop was updated

MovieTourStop

id

integer · readOnly

movieTourId

integer · readOnly

position

integer · readOnly

guest

string | null · readOnly

startDatetime

string | null · readOnly

endDatetime

string | null · readOnly

showingId

integer | null · readOnly

bookingUrl

string | null · readOnly

cinemaId

integer | null · readOnly

placeName

string | null · readOnly

cityId

integer | null · readOnly

address

string | null · readOnly

iso31661

string | null · readOnly

PATCH/movie-tour-stops/{movieTourStopId}

curl https://api.cineamo.com/movie-tour-stops/:movieTourStopId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}'

Example Request Body

{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}

json

Example Responses

{
  "id": 1,
  "movieTourId": 1,
  "position": 0,
  "guest": "John Doe",
  "startDatetime": "2026-04-11T04:11:22Z",
  "endDatetime": "2026-05-11T06:11:22Z",
  "showingId": 42,
  "bookingUrl": "https://example.com/book",
  "cinemaId": 5,
  "placeName": "Grand Cinema",
  "cityId": 10,
  "address": "123 Main St",
  "iso31661": "DE"
}

json

application/json

Cinema Showtimes Imports Showings