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
Request
path Parameters
orderId
required
string

The unique identifier of the in progress standard order being modified

showtimeId
required
string

The unique identifier of the order showtime being modified

header Parameters
Connect-Region-Code
string

Region Code

Request Body schema:
required

The requested tickets and/or seats

Array of objects or null (OrderTicketRequest)

Gets the list of order ticket request entities

seats
Array of strings or null

Gets the list of unique identifiers of the requested seat entities

Responses
200

Success

400

Request property is invalid or missing, or invalid order type.

404

Order or showtime does not exist.

put/ocapi/v1/orders/{orderId}/showtimes/{showtimeId}
Request samples
{
  • "tickets": [
    ],
  • "seats": [
    ]
}
Response samples
application/json
{
  • "order": {
    },
  • "relatedData": {
    }
}