Showtimes

Sets the requested tickets and/or seats for an order showtime within an in progress standard order

Changed on Oct 22, 2026

This endpoint cannot be used for orders that have a parent order (see standard order ParentOrderId)

Specifying Tickets without Seats (Ticket-first Ordering)

If session seat allocation is marked as None: Tickets will be booked without specific seats
If session seat allocation is marked as Manual: Tickets will be booked. Seats will be auto-allocated if possible.
If session seat allocation is marked as Auto: Tickets will be booked. Seats will be auto-allocated if possible.

Specifying Seats (Ticket-first and seat-first Ordering)

If session seat allocation is marked as None: Specifying seats is invalid - a 400 will be returned.
If session seat allocation is marked as Manual: Specified seats will be reserved if possible - otherwise a SeatsUnavailable error will be returned.
If session seat allocation is marked as Auto: Specified seats will be reserved if possible - otherwise a SeatsUnavailable error will be returned.

Auto-Allocation

The system may attempt to auto-allocate seats if specific seats are not supplied, depending on system configuration.
The auto-allocation system is not guaranteed to allocate seats. Auto-allocation may fail if seats cannot be allocated contiguously.
When allocation fails the client must render a seat plan and the seats must be manually specified.
It is recommended the client render the seat plan regardless to provide the opportunity for the customer to modify the auto-allocated selections.

Licenses Required

Vista.Ocapi

put/ocapi/v1/orders/{orderId}/showtimes/{showtimeId}

Request

Base URL
https://developer.vista.co (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/vista/apis/vista-digital-platform/docs/ocapi/v1/orders/:orderId/showtimes/:showtimeId/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

orderIdstring required

The unique identifier of the in progress standard order being modified

showtimeIdstring required

The unique identifier of the order showtime being modified

Headers

Connect-Region-Codestring

Region Code

Request body

seatsstring[] nullable

Gets the list of unique identifiers of the requested seat entities

Response

Success

Changes

Oct 22, 2026c46f30854000 Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property //// to the response with the status
Oct 9, 202641415d239083 Revision changes
- breaking
  added to the /// response property oneOf list for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the /////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new DiningLocationDelivery enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new PaymentCard enum value to the ////// response property for the response status
- warning
  added the new Tab enum value to the /// response property for the response status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  the response property // became required for the status
- info
  added the required property ///// to the response with the status
- info
  added the required property /////// to the response with the status
- info
  added the required property ///// to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property /////// to the response with the status
- info
  added the required property /////// to the response with the status

Operation history (3 revisions)