3a81c0aed14e

latestOpenAPI 3.0.12026-08-06135498863.0 KB
Showtimes

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

seatsstring[] nullable

Gets the list of unique identifiers of the requested seat entities

Response

Success