Skip to content

Vista Digital Platform (V1)

Download OpenAPI description
Languages
Servers
Mock server
https://developer.vista.co/_mock/openapi/digital-platform/openapi

Completed Order Assets

Operations

Completed Orders

Operations

Orders

Operations

Seats

Operations

Discounts

Operations

Events

Operations

Showtimes

Operations

Films

Operations

Gift Cards

Operations

Items

Operations

Gets the current list of item availability entities for a particular site

Request

Licenses Required

  • Vista.Ocapi
Path
siteIdstringrequired

The unique identifier of the site

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/sites/{siteId}/item-availability' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
itemAvailabilitiesArray of objects(ItemAvailability)required

Gets the list of item availability entities

itemAvailabilities[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

itemAvailabilities[].​statusstring(ItemAvailabilityStatus)required

Gets the availability status of the item base

Enum"Available""SoldOutForCurrentBusinessDate""SoldOutIndefinitely"
siteIdstringnon-emptyrequired

Gets the unique identifier of the site

relatedDataobject(SiteItemAvailabilityListRelatedData)required

Gets the related data for the item availability entities

relatedData.​siteLoyaltySite (object) or Site (object)required

Represents a physical location that belongs to a cinema chain, consisting of one or more screen entities

One of:

Represents a site in Vista Loyalty

relatedData.​site.​locationobject(GeographicLocation)

Gets the geographic location

relatedData.​site.​contactDetailsobject(SiteContactDetails)required

Gets the contact details

relatedData.​site.​contactDetails.​phoneNumbersArray of objects(PhoneNumber)required

Gets the list of phone number entities

relatedData.​site.​contactDetails.​phoneNumbers[].​typestring(PhoneNumberType)required

Gets the type

Enum"Home""Mobile""Work""Business""Fax"
relatedData.​site.​contactDetails.​phoneNumbers[].​numberstringnon-emptyrequired

Gets the phone number

relatedData.​site.​contactDetails.​emailstring or null

Gets the email address

relatedData.​site.​contactDetails.​addressobject(SiteAddress)

Represents the physical address of a site

relatedData.​site.​ianaTimeZoneNamestringnon-emptyrequired

Gets the IANA time zone name

Example: "America/New_York"
relatedData.​site.​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​site.​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​site.​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​site.​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​site.​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​site.​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​site.​hasSellableItemsbooleanrequired

Gets a value indicating whether the site has any sellable item entities

relatedData.​site.​allowedItemDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
Response
application/json
{ "itemAvailabilities": [ {} ], "siteId": "string", "relatedData": { "site": {} } }

Gets the current list of item availability entities for the Gift Shop

Request

Licenses Required

  • Vista.Ocapi
Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/gift-shop/item-availability \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
One of:

Represents a list of item availability entities

itemAvailabilitiesArray of objects(ItemAvailability)required

Gets the list of item availability entities

itemAvailabilities[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

itemAvailabilities[].​statusstring(ItemAvailabilityStatus)required

Gets the availability status of the item base

Enum"Available""SoldOutForCurrentBusinessDate""SoldOutIndefinitely"
Response
application/json
{ "itemAvailabilities": [ {} ] }

Gets the site item profile and its related data for a specified site

Request

Licenses Required

  • Vista.Ocapi
Path
siteIdstringrequired

The unique identifier of the site

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/sites/{siteId}/item-profile' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
itemProfileobject(SiteItemProfile)required

Gets the site item profile entity

itemProfile.​pagesArray of objects(ItemProfilePage)required

Gets the list of item profile page entities

itemProfile.​pages[].​numberinteger(int32)required

Gets the number that can be used to uniquely identify the page within the item profile

itemProfile.​pages[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​title.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​pages[].​title.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​pages[].​buttonsArray of objects(ItemProfileButton)required

Gets the list of item profile button entities

itemProfile.​pages[].​buttons[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

itemProfile.​pages[].​buttons[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

itemProfile.​pages[].​buttons[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

itemProfile.​pages[].​buttons[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

itemProfile.​pages[].​buttons[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
itemProfile.​pages[].​buttons[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

itemProfile.​pages[].​buttons[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

itemProfile.​pages[].​buttons[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

itemProfile.​pages[].​buttons[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​buttons[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​buttons[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​buttons[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​pages[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​siteIdstringnon-emptyrequired

Gets the unique identifier of the site

itemProfile.​isDefaultbooleanrequired

Gets a value indicating whether this is the default item profile for the site

itemProfile.​orderTipOptionsArray of objects(OrderTipOption)required

Gets the list of order tip option entities

itemProfile.​orderTipOptions[].​percentageinteger(int32)required

Gets the amount to tip, as a percentage of the total cost of the standard order Items

itemProfile.​orderTipOptions[].​isDefaultbooleanrequired

Gets a value indicating whether this option is applied to an in progress standard order by default

itemProfile.​itemShowtimeDeliveryWindowsArray of objects(ItemShowtimeDeliveryWindowBase)required

Gets the list of item showtime delivery window base entities

itemProfile.​itemShowtimeDeliveryWindows[].​minutesinteger(int32)required

Gets the targeted delivery time, as a number of minutes from showtime schedule StartsAt

itemProfile.​itemShowtimeDeliveryWindows[].​typestring(ItemShowtimeDeliveryWindowType)required

Gets the type

Value"MinutesFromStart"
itemProfile.​itemShowtimeDeliveryWindows[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

itemProfile.​itemShowtimeDeliveryWindows[].​nameobject(Translatable)required

Gets the name text, and its translations

itemProfile.​itemShowtimeDeliveryWindows[].​name.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​itemShowtimeDeliveryWindows[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​itemShowtimeDeliveryWindows[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​itemShowtimeDeliveryWindows[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​siteOrderLocationIdstring or null

Gets the unique identifier of the site order location, if applicable

relatedDataobject(SiteItemProfileRelatedData)required

Gets the related data for the site item profile entity

relatedData.​discountsArray of objects(Discount)required

Gets the list of related discount entities

relatedData.​discounts[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​discounts[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​discounts[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​discounts[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​discounts[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​discounts[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​discounts[].​restrictionstring(DiscountRestriction)required

Gets the restriction

Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​restrictionsArray of strings(DiscountRestriction)required

Gets the restrictions

Items Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​rewardIdsArray of integers(int32)required

Gets the list of unique identifiers of the reward entities that the discount is restricted to

relatedData.​discounts[].​voucherTypeCodesArray of stringsrequired

Gets the list of unique identifiers of the voucher types that the discount is restricted to

relatedData.​discounts[].​expiresAtstring(date-time)required

Gets the date and time that the discount expires

relatedData.​itemsArray of ItemBase (object) or RecipeItem (object)required

Gets the list of related item base entities

One of:

Represents an item base that is sold by weight, e.g. bulk candies

relatedData.​items[].​unitAbbreviationstringnon-emptyrequired
relatedData.​items[].​typestring(ItemType)required

Represents the type of an item base entity

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
relatedData.​items[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​items[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​items[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​items[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​descriptionobject(Translatable)

Gets the description text, and its translations

relatedData.​items[].​restrictionsArray of strings(ItemRestriction)required

Gets the restrictions that apply

Items Enum"Member""AvailableHours"
relatedData.​items[].​itemClassIdstring or null

Gets the unique identifier of the item class the item belongs to, if applicable

relatedData.​items[].​hopkstring or null

Gets the Head Office primary key

relatedData.​items[].​hoCodestringnon-emptyrequired

Gets the Head Office code

relatedData.​items[].​isSundrybooleanrequired

Gets a value indicating whether this is a sundry item

relatedData.​items[].​isPreparationRequiredbooleanrequired

Gets a value indicating whether the item requires preparation

relatedData.​items[].​allowedDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​items[].​availableHoursIdstring or nullread-only

Gets the unique identifier of the available hours entity

relatedData.​items[].​barcodesArray of stringsrequired

Gets the list of barcodes configured on the item at cinema

relatedData.​itemModifierGroupsArray of objects(ItemModifierGroup)required

Gets the list of related item modifier group entities

relatedData.​itemModifierGroups[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​itemModifierGroups[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemModifierGroups[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​itemModifierGroups[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​promptTextobject(Translatable)

Gets the prompt text, and its translations

relatedData.​itemModifierGroups[].​quantityLimitobject(QuantityLimit)required

Gets a value indicating the number of item modifier entities that can or must be added to a supported normal item

relatedData.​itemModifierGroups[].​quantityLimit.​isUnlimitedbooleanrequired

Gets a value indicating whether the quantity is unlimited

relatedData.​itemModifierGroups[].​quantityLimit.​maximuminteger or null(int32)

Gets the maximum quantity allowed

relatedData.​itemModifierGroups[].​quantityLimit.​minimuminteger(int32)required

Gets the minimum quantity allowed (0 by default)

relatedData.​itemModifierGroups[].​includedQuantityinteger(int32)required

Gets a value indicating the number of item modifier entities that can be added to a supported normal item at no additional charge

relatedData.​itemModifierGroups[].​modifiersArray of objects(ItemModifier)required

Gets the list of item modifier entities

relatedData.​itemModifierGroups[].​modifiers[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

relatedData.​itemModifierGroups[].​modifiers[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
relatedData.​itemModifierGroups[].​modifiers[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

relatedData.​siteLoyaltySite (object) or Site (object)required

Represents a physical location that belongs to a cinema chain, consisting of one or more screen entities

One of:

Represents a site in Vista Loyalty

relatedData.​site.​locationobject(GeographicLocation)

Gets the geographic location

relatedData.​site.​contactDetailsobject(SiteContactDetails)required

Gets the contact details

relatedData.​site.​contactDetails.​phoneNumbersArray of objects(PhoneNumber)required

Gets the list of phone number entities

relatedData.​site.​contactDetails.​phoneNumbers[].​typestring(PhoneNumberType)required

Gets the type

Enum"Home""Mobile""Work""Business""Fax"
relatedData.​site.​contactDetails.​phoneNumbers[].​numberstringnon-emptyrequired

Gets the phone number

relatedData.​site.​contactDetails.​emailstring or null

Gets the email address

relatedData.​site.​contactDetails.​addressobject(SiteAddress)

Represents the physical address of a site

relatedData.​site.​ianaTimeZoneNamestringnon-emptyrequired

Gets the IANA time zone name

Example: "America/New_York"
relatedData.​site.​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​site.​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​site.​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​site.​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​site.​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​site.​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​site.​hasSellableItemsbooleanrequired

Gets a value indicating whether the site has any sellable item entities

relatedData.​site.​allowedItemDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​availableHoursArray of objects(AvailableHours)required

Gets the list of related available hours entities

relatedData.​availableHours[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​availableHours[].​siteIdstringnon-emptyrequired

Gets the unique identifier of the site

relatedData.​availableHours[].​daysArray of objects(AvailableHoursForDay)required

Gets the available hours for the days of the week

relatedData.​availableHours[].​days[].​daystringrequired

Gets the day of week

Enum"Sunday""Monday""Tuesday""Wednesday""Thursday""Friday""Saturday"
relatedData.​availableHours[].​days[].​startTimestring(date-time)required

Gets the start time

relatedData.​availableHours[].​days[].​endTimestring(date-time)required

Gets the end time

Response
application/json
{ "itemProfile": { "pages": [], "siteId": "string", "isDefault": true, "orderTipOptions": [], "itemShowtimeDeliveryWindows": [], "siteOrderLocationId": "string" }, "relatedData": { "discounts": [], "items": [], "itemModifierGroups": [], "site": {}, "availableHours": [] } }

Gets the site item profile and its related data for a specified site and site order location

Request

Licenses Required

  • Vista.Ocapi
Path
siteIdstringrequired

The unique identifier of the site

siteOrderLocationIdstringrequired

The unique identifier of the site order location

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/sites/{siteId}/order-locations/{siteOrderLocationId}/item-profile' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
itemProfileobject(SiteItemProfile)required

Gets the site item profile entity

itemProfile.​pagesArray of objects(ItemProfilePage)required

Gets the list of item profile page entities

itemProfile.​pages[].​numberinteger(int32)required

Gets the number that can be used to uniquely identify the page within the item profile

itemProfile.​pages[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​title.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​pages[].​title.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​pages[].​buttonsArray of objects(ItemProfileButton)required

Gets the list of item profile button entities

itemProfile.​pages[].​buttons[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

itemProfile.​pages[].​buttons[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

itemProfile.​pages[].​buttons[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

itemProfile.​pages[].​buttons[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

itemProfile.​pages[].​buttons[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
itemProfile.​pages[].​buttons[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

itemProfile.​pages[].​buttons[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

itemProfile.​pages[].​buttons[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

itemProfile.​pages[].​buttons[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​buttons[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​buttons[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​buttons[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​pages[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​siteIdstringnon-emptyrequired

Gets the unique identifier of the site

itemProfile.​isDefaultbooleanrequired

Gets a value indicating whether this is the default item profile for the site

itemProfile.​orderTipOptionsArray of objects(OrderTipOption)required

Gets the list of order tip option entities

itemProfile.​orderTipOptions[].​percentageinteger(int32)required

Gets the amount to tip, as a percentage of the total cost of the standard order Items

itemProfile.​orderTipOptions[].​isDefaultbooleanrequired

Gets a value indicating whether this option is applied to an in progress standard order by default

itemProfile.​itemShowtimeDeliveryWindowsArray of objects(ItemShowtimeDeliveryWindowBase)required

Gets the list of item showtime delivery window base entities

itemProfile.​itemShowtimeDeliveryWindows[].​minutesinteger(int32)required

Gets the targeted delivery time, as a number of minutes from showtime schedule StartsAt

itemProfile.​itemShowtimeDeliveryWindows[].​typestring(ItemShowtimeDeliveryWindowType)required

Gets the type

Value"MinutesFromStart"
itemProfile.​itemShowtimeDeliveryWindows[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

itemProfile.​itemShowtimeDeliveryWindows[].​nameobject(Translatable)required

Gets the name text, and its translations

itemProfile.​itemShowtimeDeliveryWindows[].​name.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​itemShowtimeDeliveryWindows[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​itemShowtimeDeliveryWindows[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​itemShowtimeDeliveryWindows[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​siteOrderLocationIdstring or null

Gets the unique identifier of the site order location, if applicable

relatedDataobject(SiteItemProfileRelatedData)required

Gets the related data for the site item profile entity

relatedData.​discountsArray of objects(Discount)required

Gets the list of related discount entities

relatedData.​discounts[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​discounts[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​discounts[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​discounts[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​discounts[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​discounts[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​discounts[].​restrictionstring(DiscountRestriction)required

Gets the restriction

Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​restrictionsArray of strings(DiscountRestriction)required

Gets the restrictions

Items Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​rewardIdsArray of integers(int32)required

Gets the list of unique identifiers of the reward entities that the discount is restricted to

relatedData.​discounts[].​voucherTypeCodesArray of stringsrequired

Gets the list of unique identifiers of the voucher types that the discount is restricted to

relatedData.​discounts[].​expiresAtstring(date-time)required

Gets the date and time that the discount expires

relatedData.​itemsArray of ItemBase (object) or RecipeItem (object)required

Gets the list of related item base entities

One of:

Represents an item base that is sold by weight, e.g. bulk candies

relatedData.​items[].​unitAbbreviationstringnon-emptyrequired
relatedData.​items[].​typestring(ItemType)required

Represents the type of an item base entity

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
relatedData.​items[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​items[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​items[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​items[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​descriptionobject(Translatable)

Gets the description text, and its translations

relatedData.​items[].​restrictionsArray of strings(ItemRestriction)required

Gets the restrictions that apply

Items Enum"Member""AvailableHours"
relatedData.​items[].​itemClassIdstring or null

Gets the unique identifier of the item class the item belongs to, if applicable

relatedData.​items[].​hopkstring or null

Gets the Head Office primary key

relatedData.​items[].​hoCodestringnon-emptyrequired

Gets the Head Office code

relatedData.​items[].​isSundrybooleanrequired

Gets a value indicating whether this is a sundry item

relatedData.​items[].​isPreparationRequiredbooleanrequired

Gets a value indicating whether the item requires preparation

relatedData.​items[].​allowedDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​items[].​availableHoursIdstring or nullread-only

Gets the unique identifier of the available hours entity

relatedData.​items[].​barcodesArray of stringsrequired

Gets the list of barcodes configured on the item at cinema

relatedData.​itemModifierGroupsArray of objects(ItemModifierGroup)required

Gets the list of related item modifier group entities

relatedData.​itemModifierGroups[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​itemModifierGroups[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemModifierGroups[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​itemModifierGroups[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​promptTextobject(Translatable)

Gets the prompt text, and its translations

relatedData.​itemModifierGroups[].​quantityLimitobject(QuantityLimit)required

Gets a value indicating the number of item modifier entities that can or must be added to a supported normal item

relatedData.​itemModifierGroups[].​quantityLimit.​isUnlimitedbooleanrequired

Gets a value indicating whether the quantity is unlimited

relatedData.​itemModifierGroups[].​quantityLimit.​maximuminteger or null(int32)

Gets the maximum quantity allowed

relatedData.​itemModifierGroups[].​quantityLimit.​minimuminteger(int32)required

Gets the minimum quantity allowed (0 by default)

relatedData.​itemModifierGroups[].​includedQuantityinteger(int32)required

Gets a value indicating the number of item modifier entities that can be added to a supported normal item at no additional charge

relatedData.​itemModifierGroups[].​modifiersArray of objects(ItemModifier)required

Gets the list of item modifier entities

relatedData.​itemModifierGroups[].​modifiers[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

relatedData.​itemModifierGroups[].​modifiers[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
relatedData.​itemModifierGroups[].​modifiers[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

relatedData.​siteLoyaltySite (object) or Site (object)required

Represents a physical location that belongs to a cinema chain, consisting of one or more screen entities

One of:

Represents a site in Vista Loyalty

relatedData.​site.​locationobject(GeographicLocation)

Gets the geographic location

relatedData.​site.​contactDetailsobject(SiteContactDetails)required

Gets the contact details

relatedData.​site.​contactDetails.​phoneNumbersArray of objects(PhoneNumber)required

Gets the list of phone number entities

relatedData.​site.​contactDetails.​phoneNumbers[].​typestring(PhoneNumberType)required

Gets the type

Enum"Home""Mobile""Work""Business""Fax"
relatedData.​site.​contactDetails.​phoneNumbers[].​numberstringnon-emptyrequired

Gets the phone number

relatedData.​site.​contactDetails.​emailstring or null

Gets the email address

relatedData.​site.​contactDetails.​addressobject(SiteAddress)

Represents the physical address of a site

relatedData.​site.​ianaTimeZoneNamestringnon-emptyrequired

Gets the IANA time zone name

Example: "America/New_York"
relatedData.​site.​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​site.​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​site.​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​site.​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​site.​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​site.​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​site.​hasSellableItemsbooleanrequired

Gets a value indicating whether the site has any sellable item entities

relatedData.​site.​allowedItemDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​availableHoursArray of objects(AvailableHours)required

Gets the list of related available hours entities

relatedData.​availableHours[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​availableHours[].​siteIdstringnon-emptyrequired

Gets the unique identifier of the site

relatedData.​availableHours[].​daysArray of objects(AvailableHoursForDay)required

Gets the available hours for the days of the week

relatedData.​availableHours[].​days[].​daystringrequired

Gets the day of week

Enum"Sunday""Monday""Tuesday""Wednesday""Thursday""Friday""Saturday"
relatedData.​availableHours[].​days[].​startTimestring(date-time)required

Gets the start time

relatedData.​availableHours[].​days[].​endTimestring(date-time)required

Gets the end time

Response
application/json
{ "itemProfile": { "pages": [], "siteId": "string", "isDefault": true, "orderTipOptions": [], "itemShowtimeDeliveryWindows": [], "siteOrderLocationId": "string" }, "relatedData": { "discounts": [], "items": [], "itemModifierGroups": [], "site": {}, "availableHours": [] } }

Gets a sellable item for an item base with a specified head office entity Hopk for a specified site, and its related data

Request

Licenses Required

  • Vista.Ocapi
Path
siteIdstringrequired

The unique identifier of the site

itemHopkstringrequired

The head office entity Hopk of the item base

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/sites/{siteId}/sellable-items/by-hopk/{itemHopk}' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
sellableItemSellableItem (object) or ItemProfileButton (object)required

Represents the details of an item base entity that can be purchased directly

One of:

Represents the details of an item base entity that can be purchased directly

sellableItem.​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

sellableItem.​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

sellableItem.​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

sellableItem.​prices[].​price.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

sellableItem.​prices[].​price.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

sellableItem.​prices[].​price.​taxnumber(double)read-onlyrequired

Gets the amount of tax

sellableItem.​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

sellableItem.​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
sellableItem.​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

sellableItem.​prices[].​discountobject(PriceDiscount)

Gets the discount details

sellableItem.​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

relatedDataobject(SellableItemRelatedData)required

Gets the related data for the sellable item entity

relatedData.​itemItemBase (object) or RecipeItem (object)required

Represents the base properties of an item that is available for sale

One of:

Represents an item base that is sold by weight, e.g. bulk candies

relatedData.​item.​unitAbbreviationstringnon-emptyrequired
relatedData.​item.​typestring(ItemType)required

Represents the type of an item base entity

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
relatedData.​item.​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​item.​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​item.​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​item.​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​item.​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​item.​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​item.​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​item.​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​item.​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​item.​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​item.​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​item.​descriptionobject(Translatable)

Gets the description text, and its translations

relatedData.​item.​restrictionsArray of strings(ItemRestriction)required

Gets the restrictions that apply

Items Enum"Member""AvailableHours"
relatedData.​item.​itemClassIdstring or null

Gets the unique identifier of the item class the item belongs to, if applicable

relatedData.​item.​hopkstring or null

Gets the Head Office primary key

relatedData.​item.​hoCodestringnon-emptyrequired

Gets the Head Office code

relatedData.​item.​isSundrybooleanrequired

Gets a value indicating whether this is a sundry item

relatedData.​item.​isPreparationRequiredbooleanrequired

Gets a value indicating whether the item requires preparation

relatedData.​item.​allowedDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​item.​availableHoursIdstring or nullread-only

Gets the unique identifier of the available hours entity

relatedData.​item.​barcodesArray of stringsrequired

Gets the list of barcodes configured on the item at cinema

relatedData.​discountsArray of objects(Discount)required

Gets the list of related discount entities

relatedData.​discounts[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​discounts[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​discounts[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​discounts[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​discounts[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​discounts[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​discounts[].​restrictionstring(DiscountRestriction)required

Gets the restriction

Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​restrictionsArray of strings(DiscountRestriction)required

Gets the restrictions

Items Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​rewardIdsArray of integers(int32)required

Gets the list of unique identifiers of the reward entities that the discount is restricted to

relatedData.​discounts[].​voucherTypeCodesArray of stringsrequired

Gets the list of unique identifiers of the voucher types that the discount is restricted to

relatedData.​discounts[].​expiresAtstring(date-time)required

Gets the date and time that the discount expires

relatedData.​itemModifierGroupsArray of objects(ItemModifierGroup)required

Gets the list of related item modifier group entities

relatedData.​itemModifierGroups[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​itemModifierGroups[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemModifierGroups[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​itemModifierGroups[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​promptTextobject(Translatable)

Gets the prompt text, and its translations

relatedData.​itemModifierGroups[].​quantityLimitobject(QuantityLimit)required

Gets a value indicating the number of item modifier entities that can or must be added to a supported normal item

relatedData.​itemModifierGroups[].​quantityLimit.​isUnlimitedbooleanrequired

Gets a value indicating whether the quantity is unlimited

relatedData.​itemModifierGroups[].​quantityLimit.​maximuminteger or null(int32)

Gets the maximum quantity allowed

relatedData.​itemModifierGroups[].​quantityLimit.​minimuminteger(int32)required

Gets the minimum quantity allowed (0 by default)

relatedData.​itemModifierGroups[].​includedQuantityinteger(int32)required

Gets a value indicating the number of item modifier entities that can be added to a supported normal item at no additional charge

relatedData.​itemModifierGroups[].​modifiersArray of objects(ItemModifier)required

Gets the list of item modifier entities

relatedData.​itemModifierGroups[].​modifiers[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

relatedData.​itemModifierGroups[].​modifiers[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
relatedData.​itemModifierGroups[].​modifiers[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

Response
application/json
{ "sellableItem": { "itemId": "string", "prices": [] }, "relatedData": { "item": {}, "discounts": [], "itemModifierGroups": [] } }

Gets the item profile and it's related data for the Gift Shop

Request

Licenses Required

  • Vista.Ocapi
Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/gift-shop/item-profile \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
itemProfileobject(GiftShopItemProfile)required

Gets the gift shop item profile entity

itemProfile.​pagesArray of objects(ItemProfilePage)required

Gets the list of item profile page entities

itemProfile.​pages[].​numberinteger(int32)required

Gets the number that can be used to uniquely identify the page within the item profile

itemProfile.​pages[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​title.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​pages[].​title.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​pages[].​buttonsArray of objects(ItemProfileButton)required

Gets the list of item profile button entities

itemProfile.​pages[].​buttons[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

itemProfile.​pages[].​buttons[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

itemProfile.​pages[].​buttons[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

itemProfile.​pages[].​buttons[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

itemProfile.​pages[].​buttons[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
itemProfile.​pages[].​buttons[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

itemProfile.​pages[].​buttons[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

itemProfile.​pages[].​buttons[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

itemProfile.​pages[].​buttons[].​titleobject(Translatable)required

Gets the title text, and its translations

itemProfile.​pages[].​buttons[].​title.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​pages[].​buttons[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​pages[].​buttons[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​pages[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

itemProfile.​itemPostalDeliveryMethodsArray of objects(ItemPostalDeliveryMethod)required

Gets the list of related item postal delivery method entities

itemProfile.​itemPostalDeliveryMethods[].​idstringnon-emptyrequired

Gets the unique identifier

itemProfile.​itemPostalDeliveryMethods[].​nameobject(Translatable)required

Gets the name text, and its translations

itemProfile.​itemPostalDeliveryMethods[].​name.​textstringnon-emptyrequired

Gets the text in the default language

itemProfile.​itemPostalDeliveryMethods[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

itemProfile.​itemPostalDeliveryMethods[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
itemProfile.​itemPostalDeliveryMethods[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

itemProfile.​itemPostalDeliveryMethods[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default delivery method

itemProfile.​itemPostalDeliveryMethods[].​deliveryFeeobject(ItemDeliveryFeeFixedPrice)

Gets the delivery fee, if applicable

relatedDataItemProfileRelatedData (object) or SiteItemProfileRelatedData (object)required

Related data for an item profile entity

One of:

Related data for an item profile entity

relatedData.​discountsArray of objects(Discount)required

Gets the list of related discount entities

relatedData.​discounts[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​discounts[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​discounts[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​discounts[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​discounts[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​discounts[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​discounts[].​restrictionstring(DiscountRestriction)required

Gets the restriction

Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​restrictionsArray of strings(DiscountRestriction)required

Gets the restrictions

Items Enum"None""Multiple""MemberReward""Voucher""Availability"
relatedData.​discounts[].​rewardIdsArray of integers(int32)required

Gets the list of unique identifiers of the reward entities that the discount is restricted to

relatedData.​discounts[].​voucherTypeCodesArray of stringsrequired

Gets the list of unique identifiers of the voucher types that the discount is restricted to

relatedData.​discounts[].​expiresAtstring(date-time)required

Gets the date and time that the discount expires

relatedData.​itemsArray of ItemBase (object) or RecipeItem (object)required

Gets the list of related item base entities

One of:

Represents an item base that is sold by weight, e.g. bulk candies

relatedData.​items[].​unitAbbreviationstringnon-emptyrequired
relatedData.​items[].​typestring(ItemType)required

Represents the type of an item base entity

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
relatedData.​items[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​items[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​items[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​items[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​descriptionobject(Translatable)

Gets the description text, and its translations

relatedData.​items[].​restrictionsArray of strings(ItemRestriction)required

Gets the restrictions that apply

Items Enum"Member""AvailableHours"
relatedData.​items[].​itemClassIdstring or null

Gets the unique identifier of the item class the item belongs to, if applicable

relatedData.​items[].​hopkstring or null

Gets the Head Office primary key

relatedData.​items[].​hoCodestringnon-emptyrequired

Gets the Head Office code

relatedData.​items[].​isSundrybooleanrequired

Gets a value indicating whether this is a sundry item

relatedData.​items[].​isPreparationRequiredbooleanrequired

Gets a value indicating whether the item requires preparation

relatedData.​items[].​allowedDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​items[].​availableHoursIdstring or nullread-only

Gets the unique identifier of the available hours entity

relatedData.​items[].​barcodesArray of stringsrequired

Gets the list of barcodes configured on the item at cinema

relatedData.​itemModifierGroupsArray of objects(ItemModifierGroup)required

Gets the list of related item modifier group entities

relatedData.​itemModifierGroups[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​itemModifierGroups[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemModifierGroups[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​itemModifierGroups[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemModifierGroups[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemModifierGroups[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemModifierGroups[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemModifierGroups[].​promptTextobject(Translatable)

Gets the prompt text, and its translations

relatedData.​itemModifierGroups[].​quantityLimitobject(QuantityLimit)required

Gets a value indicating the number of item modifier entities that can or must be added to a supported normal item

relatedData.​itemModifierGroups[].​quantityLimit.​isUnlimitedbooleanrequired

Gets a value indicating whether the quantity is unlimited

relatedData.​itemModifierGroups[].​quantityLimit.​maximuminteger or null(int32)

Gets the maximum quantity allowed

relatedData.​itemModifierGroups[].​quantityLimit.​minimuminteger(int32)required

Gets the minimum quantity allowed (0 by default)

relatedData.​itemModifierGroups[].​includedQuantityinteger(int32)required

Gets a value indicating the number of item modifier entities that can be added to a supported normal item at no additional charge

relatedData.​itemModifierGroups[].​modifiersArray of objects(ItemModifier)required

Gets the list of item modifier entities

relatedData.​itemModifierGroups[].​modifiers[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base entity

relatedData.​itemModifierGroups[].​modifiers[].​pricesArray of objects(ItemPrice)required

Gets the list of item price entities

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default price

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​restrictionsArray of strings(ItemPriceRestriction)required

Gets the restrictions that apply

Items Enum"MemberReward""InheritedMemberReward""Discount""InheritedDiscount"
relatedData.​itemModifierGroups[].​modifiers[].​prices[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountobject(PriceDiscount)

Gets the discount details

relatedData.​itemModifierGroups[].​modifiers[].​prices[].​discountIdstring or nullread-only

Gets the unique identifier of the discount that the price is restricted to

relatedData.​itemModifierGroups[].​modifiers[].​displayPriorityinteger(int32)required

Gets the display priority used for sorting

Response
application/json
{ "itemProfile": { "pages": [], "itemPostalDeliveryMethods": [] }, "relatedData": { "discounts": [], "items": [], "itemModifierGroups": [] } }

Sets the items for an in progress standard order or in progress gift shop order

Request

Existing items on the order will be replaced with the specified selections.

Note: Items with attached scarcity such as items with selling limits currently may fail on repeated PUT as this API is currently not fully atomic.

If the order contains showtimes (see standard order Showtimes), item availability will be based on the earliest showtime.

If the order has a parent order (see standard order ParentOrderId), item availability will be based on the the start time of the earliest showtime of the parent order.

Licenses Required

  • Vista.Ocapi
Path
orderIdstringrequired

The unique identifier of the in progress standard order or in progress gift shop order being modified

Headers
Connect-Region-Codestring

Region Code

Bodyrequired

The requested items

itemsArray of OrderItemRequest (object) or OrderWeightBasedItemRequest (object)required

Gets the list of order item request base entities

One of:

Represents the base properties of a requested order item line base

items[].​idstring or null

Gets the identifier that can be used to uniquely identify the item within the order base

items[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

items[].​typestring(ItemType)required

Gets the item type

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
items[].​rewardIdinteger or null(int32)

Gets the unique identifier of the reward used, if applicable

items[].​discountIdstring or null

Gets the unique identifier of the discount used, if applicable

items[].​deliveryIdstring or null

Gets the unique identifier of the order item delivery create base, if applicable

items[].​commentstring or null

Gets the patron's comment that is sent to the kitchen, if applicable

items[].​parentSalesItemIdstring or null

Gets the unique identifier of the parent sales item this item is an option for

items[].​modifierGroupsArray of objects or null(OrderItemModifierGroupRequest)

Gets the list of order item modifier group request entities

items[].​itemsArray of objects or null(OrderPackageItemContentItemRequest)

Gets the list of order package item content item request base entities that require customisation

items[].​componentsArray of objects or null(OrderRecipeItemNormalComponentRequest)

Gets the list of order recipe item component request base entities for the recipe item component entities that require customisation

itemDeliveriesArray of OrderItemDeliveryCreateBase (object) or null

Gets the list of order item delivery create base entities, if applicable

itemDeliveriesCommentstring or null

Gets the comment that applies to all order item delivery with comment entities (including any default deliveries)

serviceAreaPickupScheduleOrderItemDeliveryScheduleBase (object)

Represents the base properties of a schedule that determines when an order item delivery base should be delivered or ready for pickup

One of:

Represents an order item delivery schedule base that should be sent for preparation immediately

curl -i -X PUT \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/orders/{orderId}/items' \
  -H 'Connect-Region-Code: string' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
      {
        "id": "string",
        "itemId": "string",
        "type": "Normal",
        "rewardId": 0,
        "discountId": "string",
        "deliveryId": "string",
        "comment": "string",
        "parentSalesItemId": "string",
        "modifierGroups": [
          {
            "itemModifierGroupId": "string",
            "modifiers": [
              {
                "itemId": "string"
              }
            ]
          }
        ],
        "items": [
          {
            "itemId": "string",
            "type": "Normal",
            "parentSalesItemId": "string",
            "modifierGroups": [
              {
                "itemModifierGroupId": "string",
                "modifiers": [
                  null
                ]
              }
            ],
            "components": [
              {
                "itemId": "string",
                "type": "Normal",
                "parentSalesItemId": "string",
                "modifierGroups": [
                  null
                ],
                "modification": "None"
              }
            ],
            "deliveryId": "string",
            "comment": "string"
          }
        ],
        "components": [
          {
            "itemId": "string",
            "type": "Normal",
            "parentSalesItemId": "string",
            "modifierGroups": [
              {
                "itemModifierGroupId": "string",
                "modifiers": [
                  null
                ]
              }
            ],
            "modification": "None"
          }
        ]
      }
    ],
    "itemDeliveries": [
      {
        "locationName": "string",
        "schedule": {
          "type": "Immediate"
        },
        "comment": "string",
        "id": "string",
        "method": "CounterPickup"
      }
    ],
    "itemDeliveriesComment": "string",
    "serviceAreaPickupSchedule": {
      "type": "Immediate"
    }
  }'

Responses

Order items

Bodyapplication/json
orderInProgressGiftShopOrder (object) or InProgressStandardOrder (object) or InProgressSubscriptionOrder (object)read-onlyrequired

Gets the in progress order base entity

One of:

Represents a gift shop order in an order status InProgress state

order.​idstring or null

Gets the unique identifier

order.​typestring(OrderType)required

Gets the type

Enum"Standard""GiftShop""Subscription"
order.​statusstring(OrderStatus)required

Gets the status

Enum"InProgress""Completed"
order.​totalPriceobject(MonetaryValue)required

Gets the total price to be displayed to the customer

order.​totalPrice.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​totalPrice.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​totalPrice.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​vouchersArray of objects(OrderVoucher)required

Gets the list of order voucher entities

order.​vouchers[].​idstringnon-emptyrequired

Gets the identifier that can be used to uniquely identify the voucher within the order base

order.​vouchers[].​typestring(VoucherType)required

Gets the type

Enum"Ticket""Subscription""Deal"
order.​vouchers[].​maskedBarcodestringnon-emptyrequired

Gets a masked representation of the barcode

Example: "12.......6789"
order.​vouchers[].​voucherTypeCodestringnon-emptyrequired

Gets the unique identifier of the voucher type

order.​vouchers[].​voucherTypeDescriptionobject(Translatable)

Gets the voucher type description text, and its translations

order.​dealsArray of objects(OrderDeal)required

Gets the list of order deal entities

order.​deals[].​idstringnon-emptyread-onlyrequired

Gets the identifier that can be used to uniquely identify the deal within the order base

order.​deals[].​dealIdstringnon-emptyread-onlyrequired

Gets the unique identifier of the deal base used

order.​deals[].​voucherIdstring or null

Gets the unique identifier of the order voucher used, if applicable

order.​paymentsArray of OrderRedirectPayment (object) or OrderMemberBalancePayment (object) or OrderGiftCardPayment (object) or OrderExternallyProcessedPayment (object) or OrderEmbeddedPayment (object) or OrderCinemaProcessedPayment (object)required

Gets the list of order payment base entities

One of:

Represents a redirect payment that has been added to an order base

order.​payments[].​idstringnon-emptyrequired

Gets the identifier that can be used to uniquely identify the payment within the order base

order.​payments[].​typestring(OrderPaymentType)required

Gets the type

Enum"CinemaProcessed""Embedded""GiftCard""Redirect""MemberBalance""ExternallyProcessed"
order.​payments[].​valuenumber(double)required

Gets the monetary value

order.​payments[].​statusstring(OrderPaymentStatus)required

Gets the status

Enum"NotStarted""Pending""Declined""Completed"
order.​itemsArray of OrderItemLineBase (object)required

Gets the list of order item line base entities

One of:

Represents the base properties of an order line for a top-level instance of an item base within a standard order or gift shop order

order.​items[].​modifierGroupsArray of objects(OrderItemModifierGroup)required

Gets the list of order item modifier group entities

order.​items[].​modifierGroups[].​itemModifierGroupIdstringnon-emptyread-onlyrequired

Gets the unique identifier of the item modifier group

order.​items[].​modifierGroups[].​modifiersArray of objects(OrderItemModifier)required

Gets the list of order item modifier entities

order.​items[].​modifierGroups[].​modifiers[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

order.​items[].​modifierGroups[].​modifiers[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

order.​items[].​modifierGroups[].​modifiers[].​amountSavedobject(MonetaryValue)required

Gets the total amount saved on the item due to all discounts and deals

order.​items[].​itemsArray of objects(OrderPackageItemContentItem)required

Gets the list of order package item content item base entities

order.​items[].​items[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

order.​items[].​items[].​typestring(ItemType)required

Gets the item type

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
order.​items[].​items[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

order.​items[].​items[].​price.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​items[].​price.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​items[].​price.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​items[].​amountSavedobject(MonetaryValue)required

Gets the total amount saved on the item due to all discounts and deals

order.​items[].​items[].​amountSaved.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​items[].​amountSaved.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​items[].​amountSaved.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​items[].​parentSalesItemIdstring or null

Gets the unique identifier of the parent sales item this item is an option for

order.​items[].​items[].​modifierGroupsArray of objects(OrderItemModifierGroup)required

Gets the list of order item modifier group entities

order.​items[].​items[].​modifierGroups[].​itemModifierGroupIdstringnon-emptyread-onlyrequired

Gets the unique identifier of the item modifier group

order.​items[].​items[].​modifierGroups[].​modifiersArray of objects(OrderItemModifier)required

Gets the list of order item modifier entities

order.​items[].​items[].​componentsArray of objects(OrderRecipeItemNormalComponent)required

Gets the components of the recipe item

order.​items[].​items[].​components[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

order.​items[].​items[].​components[].​typestring(ItemType)required

Gets the item type

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
order.​items[].​items[].​components[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

order.​items[].​items[].​components[].​amountSavedobject(MonetaryValue)required

Gets the total amount saved on the item due to all discounts and deals

order.​items[].​items[].​components[].​modificationstring(OrderRecipeItemComponentModification)required

Gets the modification

Enum"None""Remove""Extra""OnTheSide""ExtraOnTheSide"
order.​items[].​items[].​components[].​modifierGroupsArray of objects(OrderItemModifierGroup)required

Gets the list of order item modifier group entities

order.​items[].​items[].​components[].​parentSalesItemIdstring or nullread-only

Gets the unique identifier of the parent sales item this item is an option for

order.​items[].​items[].​deliveryIdstringnon-emptyrequired

Gets the unique identifier of the order item delivery base

order.​items[].​items[].​commentstring or null

Gets the patron's comment, if applicable

order.​items[].​componentsArray of objects(OrderRecipeItemNormalComponent)required

Gets the components of the recipe item

order.​items[].​components[].​itemIdstringnon-emptyrequired

Gets the unique identifier of the item base

order.​items[].​components[].​typestring(ItemType)required

Gets the item type

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
order.​items[].​components[].​priceobject(MonetaryValue)required

Gets the price to be displayed to the customer

order.​items[].​components[].​price.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​components[].​price.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​components[].​price.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​components[].​amountSavedobject(MonetaryValue)required

Gets the total amount saved on the item due to all discounts and deals

order.​items[].​components[].​amountSaved.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​components[].​amountSaved.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​components[].​amountSaved.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​components[].​modificationstring(OrderRecipeItemComponentModification)required

Gets the modification

Enum"None""Remove""Extra""OnTheSide""ExtraOnTheSide"
order.​items[].​components[].​modifierGroupsArray of objects(OrderItemModifierGroup)required

Gets the list of order item modifier group entities

order.​items[].​components[].​modifierGroups[].​itemModifierGroupIdstringnon-emptyread-onlyrequired

Gets the unique identifier of the item modifier group

order.​items[].​components[].​modifierGroups[].​modifiersArray of objects(OrderItemModifier)required

Gets the list of order item modifier entities

order.​items[].​components[].​parentSalesItemIdstring or nullread-only

Gets the unique identifier of the parent sales item this item is an option for

order.​items[].​deliveryIdstringnon-emptyrequired

Gets the unique identifier of the order item delivery base

order.​items[].​commentstring or null

Gets the patron's comment, if applicable

order.​items[].​itemIdstringnon-emptyrequired
order.​items[].​idstringnon-emptyrequired
order.​items[].​typestring(ItemType)required

Represents the type of an item base entity

Enum"Normal""ParentSales""Package""Recipe""WeightBased"
order.​items[].​priceobject(MonetaryValue)required

Represents a monetary value, and its related tax value

order.​items[].​price.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​price.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​price.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​amountSavedobject(MonetaryValue)required

Represents a monetary value, and its related tax value

order.​items[].​amountSaved.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​items[].​amountSaved.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​items[].​amountSaved.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​items[].​parentSalesItemIdstring or nullread-only
order.​items[].​collectionStatusstring(OrderLineCollectionStatus)required

Represents the collection status of an order line

Enum"NotCollected""Collected"
order.​items[].​refundStatusstring(OrderLineRefundStatus)required

Represents the refund status of an order line

Enum"NotRefunded""Refunded"
order.​items[].​refundAvailabilityCompletedOrderLineRefundAvailability (object) or CompletedWeightBasedOrderLineRefundAvailability (object) or InProgressOrderLineRefundAvailability (object)required

Represents the refund availability of an order line

One of:

Represents the refund availability of an order line

order.​items[].​refundAvailability.​isAvailablebooleanread-onlyrequired

Gets a value indicating whether the order line can be refunded

order.​items[].​refundAvailability.​unavailableReasonstring(OrderLineRefundUnavailableReason)required

Gets the reason the order line cannot be refunded

Enum"NotApplicable""NotEnabled""OrderNotCompleted""AlreadyCollected""AlreadyRefunded""ItemDeliveryPreparationStarted""ShowtimeRefundWindowEnded""VoucherRedeemed""RedeemableItemIssued""OrderExpired"
order.​items[].​rewardIdinteger or null(int32)
order.​items[].​discountIdstring or nullread-only
order.​items[].​dealIdstring or null
order.​expiresAtstring(date-time)required

Gets the date and time that the order is set to expire

order.​hasCustomerbooleanrequired

Gets a value indicating whether the order customer has been set

order.​amountSavedobject(MonetaryValue)required

Gets the monetary amount saved via discounted prices

order.​amountSaved.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​amountSaved.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​amountSaved.​taxnumber(double)read-onlyrequired

Gets the amount of tax

order.​itemDeliveriesArray of OrderItemDeliveryBase (object) or CompletedOrderItemCounterPickup (object) or CompletedOrderItemCustomLocationDelivery (object) or CompletedOrderItemElectronicDelivery (object) or CompletedOrderItemInSeatDelivery (object) or CompletedOrderItemPostalDelivery (object) or CompletedOrderItemServiceAreaPickup (object)required

Gets the list of order item delivery base entities for the gift shop order Items

One of:

Represents an order item delivery base for items that can be picked up by the patron from the counter at any time, as they do not require preparation

order.​itemDeliveries[].​methodstring(ItemDeliveryMethod)required

Gets the delivery method

Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
order.​itemDeliveries[].​idstringnon-emptyrequired

Gets the identifier that can be used to uniquely identify the delivery within the standard order

order.​totalItemDeliveryFeeobject(MonetaryValue)required

Gets the total fee for the in progress gift shop order ItemDeliveries

order.​totalItemDeliveryFee.​valueIncludingTaxnumber(double)read-onlyrequired

Gets the monetary value including tax

order.​totalItemDeliveryFee.​valueExcludingTaxnumber(double)read-onlyrequired

Gets the monetary value excluding tax

order.​totalItemDeliveryFee.​taxnumber(double)read-onlyrequired

Gets the amount of tax

relatedDataobject(OrderRelatedData)required

Gets the related data for the in progress order base entity

relatedData.​filmsArray of objects(OrderRelatedFilm)required

Gets the list of related order related film entities

relatedData.​films[].​idstringnon-emptyrequired
relatedData.​films[].​titleobject(Translatable)required

Represents some customer-visible translatable Text in the default language, and a list of translation entities

relatedData.​films[].​title.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​films[].​title.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​films[].​title.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​films[].​title.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​films[].​externalIdsobject(FilmExternalIds)required

Represents the external identifiers linked to a film

relatedData.​films[].​externalIds.​moviexchangeReleaseIdstring or null(uuid)

Gets the unique identifier of the linked movieXchange film release entity

relatedData.​films[].​externalIds.​corporateIdstring or null

Gets the unique corporate identifier

relatedData.​films[].​censorRatingIdstring or null
relatedData.​films[].​censorRatingNoteobject(Translatable)

Represents some customer-visible translatable Text in the default language, and a list of translation entities

relatedData.​ticketTypesArray of objects(OrderRelatedTicketType)required

Gets the list of related order related ticket type entities

relatedData.​ticketTypes[].​idstringnon-emptyread-onlyrequired
relatedData.​ticketTypes[].​descriptionobject(Translatable)required

Represents some customer-visible translatable Text in the default language, and a list of translation entities

relatedData.​ticketTypes[].​description.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​ticketTypes[].​description.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​ticketTypes[].​description.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​ticketTypes[].​description.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​ticketTypes[].​longDescriptionobject(Translatable)required

Represents some customer-visible translatable Text in the default language, and a list of translation entities

relatedData.​ticketTypes[].​longDescription.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​ticketTypes[].​longDescription.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​ticketTypes[].​longDescription.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​ticketTypes[].​longDescription.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemsArray of objects(OrderRelatedItem)required

Gets the list of related order related item entities

relatedData.​items[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​items[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​items[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​items[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​items[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​items[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​items[].​hoCodestringnon-emptyrequired

Gets the Head Office code

relatedData.​items[].​hopkstring or null

Gets the Head Office primary key

relatedData.​items[].​isSundryboolean

Gets a value indicating whether this is a sundry item

relatedData.​items[].​isPreparationRequiredboolean

Gets a value indicating whether the item requires preparation

relatedData.​showtimesArray of objects(OrderRelatedShowtime)required

Gets the list of related order related showtime entities

relatedData.​showtimes[].​idstringnon-emptyread-onlyrequired
relatedData.​showtimes[].​scheduleobject(ShowtimeSchedule)required

Represents the dates and times relevant to a showtime, e.g. its start, end, film start, etc

relatedData.​showtimes[].​schedule.​businessDatestring(date-time)required

Gets the showtime entity's business date

relatedData.​showtimes[].​schedule.​startsAtstring(date-time)required

Gets the date and time that the showtime starts

relatedData.​showtimes[].​schedule.​endsAtstring(date-time)required

Gets the date and time that the showtime ends

relatedData.​showtimes[].​schedule.​filmStartsAtstring(date-time)required

Gets the date and time that the film screening starts

relatedData.​showtimes[].​schedule.​filmEndsAtstring(date-time)required

Gets the date and time that the film screening ends

relatedData.​showtimes[].​schedule.​inSeatItemDeliveryobject(ShowtimeInSeatItemDeliverySchedule)

Gets the showtime in seat item delivery schedule entity, if applicable

relatedData.​showtimes[].​filmIdstringnon-emptyrequired
relatedData.​showtimes[].​siteIdstringnon-emptyrequired
relatedData.​showtimes[].​screenIdstringnon-emptyread-onlyrequired
relatedData.​sitesArray of LoyaltySite (object) or Site (object)required

Gets the list of related site entities

One of:

Represents a site in Vista Loyalty

relatedData.​sites[].​locationobject(GeographicLocation)

Gets the geographic location

relatedData.​sites[].​contactDetailsobject(SiteContactDetails)required

Gets the contact details

relatedData.​sites[].​contactDetails.​phoneNumbersArray of objects(PhoneNumber)required

Gets the list of phone number entities

relatedData.​sites[].​contactDetails.​phoneNumbers[].​typestring(PhoneNumberType)required

Gets the type

Enum"Home""Mobile""Work""Business""Fax"
relatedData.​sites[].​contactDetails.​phoneNumbers[].​numberstringnon-emptyrequired

Gets the phone number

relatedData.​sites[].​contactDetails.​emailstring or null

Gets the email address

relatedData.​sites[].​contactDetails.​addressobject(SiteAddress)

Represents the physical address of a site

relatedData.​sites[].​ianaTimeZoneNamestringnon-emptyrequired

Gets the IANA time zone name

Example: "America/New_York"
relatedData.​sites[].​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​sites[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​sites[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​sites[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​sites[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​sites[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​sites[].​hasSellableItemsbooleanrequired

Gets a value indicating whether the site has any sellable item entities

relatedData.​sites[].​allowedItemDeliveryMethodsArray of strings(ItemDeliveryMethod)required

Gets the list of allowed item delivery method entities

Items Enum"CounterPickup""ServiceAreaPickup""ElectronicDelivery""InSeatDelivery""CustomLocationDelivery""PostalDelivery"
relatedData.​screensArray of objects(Screen)required

Gets the list of related screen entities

relatedData.​screens[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​screens[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​screens[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​screens[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​screens[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​screens[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​censorRatingsArray of objects(CensorRating)required

Gets the list of related censor rating entities

relatedData.​censorRatings[].​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​censorRatings[].​classificationobject(Translatable)required

Gets the classification text, and its translations

relatedData.​censorRatings[].​classification.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​censorRatings[].​classification.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​censorRatings[].​classification.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​censorRatings[].​classification.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​censorRatings[].​classificationDescriptionobject(Translatable)

Gets the censor rating Classification description text, and its translations

relatedData.​censorRatings[].​ageRestrictionobject(CensorRatingAgeRestriction)

Gets the age restriction, if applicable

relatedData.​itemServiceAreasArray of objects(ItemServiceArea)required

Gets the list of related item service area entities

relatedData.​itemServiceAreas[].​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​itemServiceAreas[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemServiceAreas[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemServiceAreas[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemServiceAreas[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemServiceAreas[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemServiceAreas[].​shortNameobject(Translatable)required

Gets the short name text, and its translations

relatedData.​itemServiceAreas[].​shortName.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemServiceAreas[].​shortName.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemServiceAreas[].​shortName.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemServiceAreas[].​shortName.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​itemShowtimeDeliveryWindowsArray of objects(ItemShowtimeDeliveryWindowBase)required

Gets the list of related item showtime delivery window base entities

relatedData.​itemShowtimeDeliveryWindows[].​minutesinteger(int32)required

Gets the targeted delivery time, as a number of minutes from showtime schedule StartsAt

relatedData.​itemShowtimeDeliveryWindows[].​typestring(ItemShowtimeDeliveryWindowType)required

Gets the type

Value"MinutesFromStart"
relatedData.​itemShowtimeDeliveryWindows[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​itemShowtimeDeliveryWindows[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemShowtimeDeliveryWindows[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemShowtimeDeliveryWindows[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemShowtimeDeliveryWindows[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemShowtimeDeliveryWindows[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​subscriptionBillingOptionobject(OrderRelatedSubscriptionBillingOption)

Gets the related order related subscription billing option entity

relatedData.​subscriptionobject(OrderRelatedSubscription)

Gets the related order related subscription entity

relatedData.​balanceTypeobject(BalanceType)

Gets the related balance type entity, if applicable

relatedData.​areaCategoriesArray of objects(AreaCategory)required

Gets the list of related area category entities

relatedData.​areaCategories[].​idstringnon-emptyread-onlyrequired

Gets the unique identifier

relatedData.​areaCategories[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​areaCategories[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​areaCategories[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​areaCategories[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​areaCategories[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

relatedData.​areaCategories[].​hopkstring or null

Gets the Head Office primary key

relatedData.​areaCategories[].​isAllocatedSeatingbooleanrequired

Gets a value indicating whether the seat entities are allocated

relatedData.​areaCategories[].​isInSeatItemDeliveryAvailablebooleanrequired

Gets a value indicating whether in-seat item delivery is available for seats belonging to this area category

relatedData.​itemPostalDeliveryMethodsArray of objects(OrderRelatedItemPostalDeliveryMethod)required

Gets the list of related order related item postal delivery method entities

relatedData.​itemPostalDeliveryMethods[].​isDefaultbooleanrequired

Gets a value indicating whether this is the default delivery method

relatedData.​itemPostalDeliveryMethods[].​idstringnon-emptyrequired

Gets the unique identifier

relatedData.​itemPostalDeliveryMethods[].​nameobject(Translatable)required

Gets the name text, and its translations

relatedData.​itemPostalDeliveryMethods[].​name.​textstringnon-emptyrequired

Gets the text in the default language

relatedData.​itemPostalDeliveryMethods[].​name.​translationsArray of objects(Translation)required

Gets the translations of the translatable Text in other languages

relatedData.​itemPostalDeliveryMethods[].​name.​translations[].​languageTagstringnon-emptyrequired

Gets the IETF (RFC 4646) language tag that the translation Text has been translated for

Example: "en-US"
relatedData.​itemPostalDeliveryMethods[].​name.​translations[].​textstringnon-emptyrequired

Gets the translated text

Response
application/json
{ "order": { "id": "string", "type": "Standard", "status": "InProgress", "totalPrice": {}, "vouchers": [], "deals": [], "payments": [], "items": [], "expiresAt": "2019-08-24T14:15:22Z", "hasCustomer": true, "amountSaved": {}, "itemDeliveries": [], "totalItemDeliveryFee": {} }, "relatedData": { "films": [], "ticketTypes": [], "items": [], "showtimes": [], "sites": [], "screens": [], "censorRatings": [], "itemServiceAreas": [], "itemShowtimeDeliveryWindows": [], "subscriptionBillingOption": {}, "subscription": {}, "balanceType": {}, "areaCategories": [], "itemPostalDeliveryMethods": [] } }

Journeys

Operations

Third Party Passes

Operations

Loyalty

Operations

Authentication

Operations

Members

Operations

Member Completed Orders

Operations

Friends

Operations

Password Reset

Operations

Payments

Operations

Member Rewards

Operations

Subscriptions

Operations

Ticket Redemption Cards

Operations

Credentials

Operations

Watched Films

Operations

Watchlist Films

Operations

Completion

Operations

Gift shop

Operations

Vouchers

Operations

Refunds

Operations

Seating

Operations

Browsing

Operations

Sites

Operations

Surveys

Operations

Third-Party Member Schemes

Operations

Ticket Prices

Operations

Tracking Events

Operations

Tips

Operations