Gets a list of tickets prices for a specified showtime

Returns a list of ITicketPrice for a showtime with related data.

Restrictions

Some ticket prices have restrictions that limit their availability. These restrictions are returned in the restrictions property. If a restriction is returned that a client does not understand, the price must be hidden until the client has implemented handling for said requirement.

Current ticket price restrictions include:

  • Member - A Loyalty membership is required.
  • MemberReward - Redemption of member reward with the specified LoyaltyRewardId is required.
  • ThirdPartyMembership - A third party membership with the specified ThirdPartyMemberSchemeId is required.
  • Voucher - Redemption of a voucher, valid for the ticket type, is required.
  • Discount - Redemption of discount with the specified DiscountId is required.

Quantity limits

  • The quantity limits of each ticket price available to the customer is complex.
  • Due to quantity limits potentially applying across multiple ticket prices, these rules are best calculated on the client.
  • The client must keep track of various ticket properties to correctly restrict quantity. These properties include:
  • A client-side max-tickets-per-order setting (this does not exist as omnichannel config yet)
  • The QuantityLimit of the Loyalty reward if applicable.
  • The BalanceCost of the Loyalty reward if applicable (checked against member balance + other ticket selections).
  • Member ticket QuantityLimit returned from 3rd party member card validation.

Licenses Required

  • Vista.Ocapi
  • Vista.Ocapi.TicketPricesForShowtime
Request
path Parameters
showtimeId
required
string

The unique identifier of the showtime

header Parameters
Connect-Region-Code
string

Region Code

Responses
200

Success

404

Showtime does not exist.

get/ocapi/v1/showtimes/{showtimeId}/ticket-prices
Request samples
Response samples
application/json
{
  • "ticketPrices": [
    ],
  • "relatedData": {
    }
}