--- title: "Gets a list of tickets prices for a specified showtime" method: GET path: "/ocapi/v1/showtimes/{showtimeId}/ticket-prices" tags: ["Ticket Prices"] --- # Gets a list of tickets prices for a specified showtime `GET /ocapi/v1/showtimes/{showtimeId}/ticket-prices` Returns a list of ticket price entities 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 `RewardId` is required. * `MemberSubscriptionCard` - A subscription for the specified `ThirdPartyMemberSchemeId` is required. * `ThirdPartyMemberCard` - A third-party membership card belonging to 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. ### Loyalty-based third-party member schemes Ticket prices for Loyalty-based non-subscription third party member schemes will be returned twice: * Once with a `ThirdPartyMemberCard` restriction intended for legacy clients adding these tickets via `AddTicketRedemptionCard`. * Once with a `MemberReward` restriction intended for clients using the `GetMemberRewardAvailabilitiesForShowtime` endpoint and adding these tickets directly using the `RewardId`. ### 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 `AvailableQuantity` of the member reward if applicable. * The `BalanceCost` of the reward if applicable (checked against member balance + other ticket selections). * Member ticket `QuantityLimit` returned from third-party member card validation. Discounted ticket price entities are automatically filtered based on the discount restriction Availability for the showtime #### Licenses Required - Vista.Ocapi - Vista.Ocapi.TicketPricesForShowtime ## Path parameters - `showtimeId` string, required ## Headers - `Connect-Region-Code` string ## Response `200` Success - OcapiV1SalesMasterDataTicketPricesTicketPriceListDetails — Represents a list of ticket price entities, and their related data - `ticketPrices` OcapiV1SalesMasterDataTicketPricesTicketPrice[], required — Gets the list of ticket price entities - `ticketTypeId` string, required — Gets the unique identifier of the ticket type base - `price` OcapiV1MonetaryValue, required — Represents a monetary value, and its related tax value - `valueIncludingTax` number, double, required — Gets the monetary value including tax - `valueExcludingTax` number, double, required — Gets the monetary value excluding tax - `tax` number, double, required — Gets the amount of tax - `isDefault` boolean, required — Gets a value indicating whether this is the default price - `bookingFee` OcapiV1SalesMasterDataTicketPricesTicketPriceBookingFee — Represents a booking fee that will be incurred with the purchase of a ticket price - `amountIncludingTax` number, double, required — Gets the monetary amount including tax to be displayed to the customer - `restrictions` OcapiV1SalesMasterDataTicketPricesTicketPriceRestriction[], required — Gets the restrictions that apply - `rewardId` integer, nullable — Gets the unique identifier of the reward that the price is restricted to - `voucherTypeCodes` string[], required — Gets the list of unique identifiers of the voucher types that the price is restricted to - `thirdPartyMemberSchemeId` string, nullable — Gets the unique identifier of the third party member scheme that the price is restricted to - `isShownAsPreviewWhenRestricted` boolean, required — Gets a value indicating whether this price should be previewed to the user if it is not available for purchase due to some unmet restriction - `displayPriority` integer, required — Gets the display priority used for sorting - `subscriptionId` integer, nullable — Gets the unique identifier of the subscription that the price is restricted to - `discountId` string, nullable — Gets the unique identifier of the discount that the price is restricted to - `discount` OcapiV1SalesMasterDataPricesPriceDiscount — Represents the calculation logic and savings associated with a discounted price - `calculation` union, required — Represents the base properties that describe the calculation of a discount - OcapiV1DiscountCalculationsPercentageOffDiscountCalculation — Represents a percentage-off type of discount calculation base - `percentageOff` number, double, required — Gets the percentage off the default price, e.g. 12.5% off - `type` 'SpecialPrice' | 'PercentageOff' | 'PriceOff', required — Represents the type of a discount calculation base - OcapiV1DiscountCalculationsPriceOffDiscountCalculation — Represents a price-off type of discount calculation base - `priceOff` number, double, required — Gets the value of the discount off the default price, e.g. $2.00 off - `type` 'SpecialPrice' | 'PercentageOff' | 'PriceOff', required — Represents the type of a discount calculation base - OcapiV1DiscountCalculationsSpecialPriceDiscountCalculation — Represents a special-price type of discount calculation base - `specialPrice` number, double, required — Gets the value of the special price defined by the discount, e.g. now $1.50 - `type` 'SpecialPrice' | 'PercentageOff' | 'PriceOff', required — Represents the type of a discount calculation base - `amountSaved` OcapiV1MonetaryValue, required — Represents a monetary value, and its related tax value - `valueIncludingTax` number, double, required — Gets the monetary value including tax - `valueExcludingTax` number, double, required — Gets the monetary value excluding tax - `tax` number, double, required — Gets the amount of tax - `relatedData` OcapiV1SalesMasterDataTicketPricesTicketPriceListRelatedData, required — Related data for a list of ticket price entities - `ticketTypes` union[], required — Gets the list of related ticket type base entities - union — Represents the base properties of a ticket type - OcapiV1SalesMasterDataTicketTypesPackagePackageTicketType - `id` string, required — Gets the unique identifier - `type` 'Normal' | 'Package', required — Represents the type of a ticket type base entity - `description` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `longDescription` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `areaCategoryId` string, required — Gets the unique identifier of the area category the ticket type belongs to - `isRestrictedToMembers` boolean, required — Gets a value indicating whether this ticket type is restricted to member entities - `displayPriority` integer, required — Gets the display priority used for sorting - `isChildTicket` boolean, required — Gets a value indicating whether this ticket is intended for children and may be subject to sale restrictions based on film and/or censor rating rules - `hopk` string, nullable - `ticketCode` string, nullable - `hoCode` string, required - OcapiV1SalesMasterDataTicketTypesNormalNormalTicketType - `id` string, required — Gets the unique identifier - `type` 'Normal' | 'Package', required — Represents the type of a ticket type base entity - `description` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `longDescription` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `areaCategoryId` string, required — Gets the unique identifier of the area category the ticket type belongs to - `isRestrictedToMembers` boolean, required — Gets a value indicating whether this ticket type is restricted to member entities - `displayPriority` integer, required — Gets the display priority used for sorting - `isChildTicket` boolean, required — Gets a value indicating whether this ticket is intended for children and may be subject to sale restrictions based on film and/or censor rating rules - `hopk` string, nullable - `ticketCode` string, nullable - `hoCode` string, required - `items` union[], required — Gets the list of related item base entities for any package ticket type entities - union — Represents the base properties of an item that is available for sale - OcapiV1SalesMasterDataItemsWeightBasedWeightBasedItem — Represents the base properties of an item that is available for sale - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `shortName` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `description` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `restrictions` OcapiV1SalesMasterDataItemsItemRestriction[], required — Gets the restrictions that apply - `type` 'Normal' | 'ParentSales' | 'Package' | 'Recipe' | 'WeightBased', required — Represents the type of an item base entity - `itemClassId` string, nullable — Gets the unique identifier of the item class the item belongs to, if applicable - `hopk` string, nullable — Gets the Head Office primary key - `hoCode` string, required — Gets the Head Office code - `isSundry` boolean, required — Gets a value indicating whether this is a sundry item - `isPreparationRequired` boolean, required — Gets a value indicating whether the item requires preparation - `allowedDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required — Gets the list of allowed item delivery method entities - `availableHoursId` string, nullable — Gets the unique identifier of the available hours entity - `barcodes` string[], required — Gets the list of barcodes configured on the item at cinema - OcapiV1SalesMasterDataItemsRecipeRecipeItem — Represents an item base that supports item modifier group entities and has one or more recipe item Components, e.g. a drink made up of a cup, straw, post-mix syrup, and ice - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `shortName` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `description` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `restrictions` OcapiV1SalesMasterDataItemsItemRestriction[], required — Gets the restrictions that apply - `itemClassId` string, nullable — Gets the unique identifier of the item class the item belongs to, if applicable - `hopk` string, nullable — Gets the Head Office primary key - `hoCode` string, required — Gets the Head Office code - `isSundry` boolean, required — Gets a value indicating whether this is a sundry item - `isPreparationRequired` boolean, required — Gets a value indicating whether the item requires preparation - `allowedDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required — Gets the list of allowed item delivery method entities - `availableHoursId` string, nullable — Gets the unique identifier of the available hours entity - `barcodes` string[], required — Gets the list of barcodes configured on the item at cinema - `modifierGroups` OcapiV1SalesMasterDataItemsNormalNormalItemModifierGroup[], required — Gets the list of normal item modifier group entities - `itemModifierGroupId` string, required — Gets the unique identifier of the item modifier group - `displayPriority` integer, required — Gets the display priority used for sorting - `type` 'Normal' | 'ParentSales' | 'Package' | 'Recipe' | 'WeightBased', required — Represents the type of an item base entity - `components` OcapiV1SalesMasterDataItemsRecipeRecipeItemComponent[], required — Gets the list of recipe item component entities - `itemId` string, required — Gets the unique identifier of the item base entity - `isModifiable` boolean, required — Gets a value indicating whether the component can be modified via an order recipe item component modification - `displayPriority` integer, required — Gets the display priority used for sorting - `prices` OcapiV1SalesMasterDataItemsPricesItemPrice[], required — Gets the list of item price entities incurred when adding extra of the component to the recipe - … - OcapiV1SalesMasterDataItemsParentSalesParentSalesItem — Represents the base properties of an item that is available for sale - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `shortName` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `description` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `restrictions` OcapiV1SalesMasterDataItemsItemRestriction[], required — Gets the restrictions that apply - `type` 'Normal' | 'ParentSales' | 'Package' | 'Recipe' | 'WeightBased', required — Represents the type of an item base entity - `itemClassId` string, nullable — Gets the unique identifier of the item class the item belongs to, if applicable - `hopk` string, nullable — Gets the Head Office primary key - `hoCode` string, required — Gets the Head Office code - `isSundry` boolean, required — Gets a value indicating whether this is a sundry item - `isPreparationRequired` boolean, required — Gets a value indicating whether the item requires preparation - `allowedDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required — Gets the list of allowed item delivery method entities - `availableHoursId` string, nullable — Gets the unique identifier of the available hours entity - `barcodes` string[], required — Gets the list of barcodes configured on the item at cinema - OcapiV1SalesMasterDataItemsPackagesPackageItem — Represents the base properties of an item that is available for sale - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `shortName` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `description` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `restrictions` OcapiV1SalesMasterDataItemsItemRestriction[], required — Gets the restrictions that apply - `type` 'Normal' | 'ParentSales' | 'Package' | 'Recipe' | 'WeightBased', required — Represents the type of an item base entity - `itemClassId` string, nullable — Gets the unique identifier of the item class the item belongs to, if applicable - `hopk` string, nullable — Gets the Head Office primary key - `hoCode` string, required — Gets the Head Office code - `isSundry` boolean, required — Gets a value indicating whether this is a sundry item - `isPreparationRequired` boolean, required — Gets a value indicating whether the item requires preparation - `allowedDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required — Gets the list of allowed item delivery method entities - `availableHoursId` string, nullable — Gets the unique identifier of the available hours entity - `barcodes` string[], required — Gets the list of barcodes configured on the item at cinema - OcapiV1SalesMasterDataItemsNormalNormalItem — Represents the base properties of an item that is available for sale - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `shortName` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `description` OcapiV1Translatable — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - … - `restrictions` OcapiV1SalesMasterDataItemsItemRestriction[], required — Gets the restrictions that apply - `type` 'Normal' | 'ParentSales' | 'Package' | 'Recipe' | 'WeightBased', required — Represents the type of an item base entity - `itemClassId` string, nullable — Gets the unique identifier of the item class the item belongs to, if applicable - `hopk` string, nullable — Gets the Head Office primary key - `hoCode` string, required — Gets the Head Office code - `isSundry` boolean, required — Gets a value indicating whether this is a sundry item - `isPreparationRequired` boolean, required — Gets a value indicating whether the item requires preparation - `allowedDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required — Gets the list of allowed item delivery method entities - `availableHoursId` string, nullable — Gets the unique identifier of the available hours entity - `barcodes` string[], required — Gets the list of barcodes configured on the item at cinema - `discounts` OcapiV1SalesMasterDataDiscountsDiscount[], required — Gets the list of related discount entities - `id` string, required — Gets the unique identifier - `name` OcapiV1Translatable, required — Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required — Gets the text in the default language - `translations` OcapiV1Translation[], required — Gets the translations of the translatable Text in other languages - `languageTag` string, required — Gets the IETF (RFC 4646) language tag that the translation Text has been translated for - `text` string, required — Gets the translated text - `restriction` 'None' | 'Multiple' | 'MemberReward' | 'Voucher' | 'Availability', required — Represents the restriction options for a discount - `restrictions` OcapiV1SalesMasterDataDiscountsDiscountRestriction[], required — Gets the restrictions - `rewardIds` integer[], required — Gets the list of unique identifiers of the reward entities that the discount is restricted to - `voucherTypeCodes` string[], required — Gets the list of unique identifiers of the voucher types that the discount is restricted to - `expiresAt` string, date-time, required — Gets the date and time that the discount expires ## Other responses - `404` — Showtime does not exist. --- [API](https://skmtc.net/vista/apis/vista-digital-platform.md) · [All operations](https://skmtc.net/vista/apis/vista-digital-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vista/vista-digital-platform/revisions/3a81c0aed14e/schema)