3a81c0aed14e
latestOpenAPI 3.0.12026-08-06135498863.0 KBShowtimes
Sets the requested tickets and/or seats for an order showtime within an in progress standard order
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}
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
Response
Success