--- title: "Gets the current list of item availability entities for the Gift Shop" method: GET path: "/ocapi/v1/gift-shop/item-availability" tags: ["Items"] --- # Gets the current list of item availability entities for the Gift Shop `GET /ocapi/v1/gift-shop/item-availability` ## Request - Base URL: `https://developer.vista.co` (the document declares no server; this is the origin it was published from) - URL: `https://developer.vista.co/ocapi/v1/gift-shop/item-availability` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) #### Licenses Required - Vista.Ocapi ## Headers - `Connect-Region-Code` string ## Response `200` Success - union: Represents a list of item availability entities - OcapiV1SalesAvailabilityItemAvailabilityListDetails: Represents a list of item availability entities - `itemAvailabilities` OcapiV1SalesAvailabilityItemAvailability[], required: Gets the list of item availability entities - `itemId` string, required: Gets the unique identifier of the item base - `status` 'Available' | 'SoldOutForCurrentBusinessDate' | 'SoldOutIndefinitely', required: Represents the availability status of an item base - OcapiV1SalesAvailabilitySiteItemAvailabilityListDetails: Represents a list of item availability entities for a particular site, and their related data - `itemAvailabilities` OcapiV1SalesAvailabilityItemAvailability[], required: Gets the list of item availability entities - `itemId` string, required: Gets the unique identifier of the item base - `status` 'Available' | 'SoldOutForCurrentBusinessDate' | 'SoldOutIndefinitely', required: Represents the availability status of an item base - `siteId` string, required: Gets the unique identifier of the site - `isDefault` boolean, required: Gets a value indicating whether this is the default item availability list details for the site - `siteOrderLocationId` string, nullable: Gets the unique identifier of the site order location, if applicable - `relatedData` OcapiV1SalesAvailabilitySiteItemAvailabilityListRelatedData, required: Related data for a list of item availability entities - `site` union, required: Represents a physical location that belongs to a cinema chain, consisting of one or more screen entities - OcapiV1LoyaltyMasterDataSitesLoyaltySite: Represents a site in Vista Loyalty - `location` OcapiV1GeographicLocation: Represents a set of geospatial coordinates; longitude and latitude, that can be used to pinpoint a location on a map - `latitude` number, double, required: Gets the latitude (expressed in degrees and minutes) - `longitude` number, double, required: Gets the longitude (expressed in degrees and minutes) - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required: Represents the contact details of a site - `phoneNumbers` OcapiV1PhoneNumber[], required: Gets the list of phone number entities - … - `email` string, nullable: Gets the email address - `address` OcapiV1BrowsingMasterDataSitesSiteAddress: Represents the physical address of a site - … - `addressV2` OcapiV1BrowsingMasterDataSitesSiteAddressV2, required: Represents the physical address of a site - … - `ianaTimeZoneName` string, required: Gets the IANA time zone name - `id` string, required: Gets the unique identifier - `name` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - … - `hasSellableItems` boolean, required: Gets a value indicating whether the site has any sellable item entities - `allowedItemDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required: Gets the list of allowed item delivery method entities - OcapiV1BrowsingMasterDataSitesSite: Represents a physical location that belongs to a cinema chain, consisting of one or more screen entities - `id` string, required: Gets the unique identifier - `name` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - … - `location` OcapiV1GeographicLocation: Represents a set of geospatial coordinates; longitude and latitude, that can be used to pinpoint a location on a map - `latitude` number, double, required: Gets the latitude (expressed in degrees and minutes) - `longitude` number, double, required: Gets the longitude (expressed in degrees and minutes) - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required: Represents the contact details of a site - `phoneNumbers` OcapiV1PhoneNumber[], required: Gets the list of phone number entities - … - `email` string, nullable: Gets the email address - `address` OcapiV1BrowsingMasterDataSitesSiteAddress: Represents the physical address of a site - … - `addressV2` OcapiV1BrowsingMasterDataSitesSiteAddressV2, required: Represents the physical address of a site - … - `ianaTimeZoneName` string, required: Gets the IANA time zone name - `hasSellableItems` boolean, required: Gets a value indicating whether the site has any sellable item entities - `allowedItemDeliveryMethods` OcapiV1SalesMasterDataItemsDeliveryMethodsItemDeliveryMethod[], required: Gets the list of allowed item delivery method entities ## Other responses - `404`: Gift shop does not exist. ## Changes - **2026-10-09** `41415d239083`: 2 warning, 4 info - added the new `DiningLocationDelivery` enum value to the `oneOf[subschema #2: SiteItemAvailabilityListDetails]/relatedData/allOf[subschema #1: SiteItemAvailabilityListRelatedData]/site/oneOf[subschema #1: LoyaltySite]/allowedItemDeliveryMethods/items/` response property for the response status `200` - added the new `DiningLocationDelivery` enum value to the `oneOf[subschema #2: SiteItemAvailabilityListDetails]/relatedData/allOf[subschema #1: SiteItemAvailabilityListRelatedData]/site/oneOf[subschema #2: Site]/allowedItemDeliveryMethods/items/` response property for the response status `200` - added the optional property `oneOf[subschema #2: SiteItemAvailabilityListDetails]/siteOrderLocationId` to the response with the `200` status - added the required property `oneOf[subschema #2: SiteItemAvailabilityListDetails]/isDefault` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/vista/apis/vista-digital-platform/changes/ocapi/v1/gift-shop/item-availability/get.md) --- [API](https://skmtc.dev/vista/apis/vista-digital-platform.md) - [All operations](https://skmtc.dev/vista/apis/vista-digital-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/vista/apis/vista-digital-platform/revisions/c46f30854000?raw)