--- title: "Gets the current list of item availability entities for a particular site" method: GET path: "/ocapi/v1/sites/{siteId}/item-availability" tags: ["Items"] --- # Gets the current list of item availability entities for a particular site `GET /ocapi/v1/sites/{siteId}/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/sites/{siteId}/item-availability` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Use [GetItemAvailabilitiesForSiteOrderLocation](/openapi/digital-platform/openapi/items/ocapiitemavailability_getitemavailabilitiesforsiteorderlocation) to get the site item availability list details for a particular site order location #### Licenses Required - Vista.Ocapi ## Path parameters - `siteId` string, required ## Headers - `Connect-Region-Code` string ## Response `200` Success - 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 - `type` 'Home' | 'Mobile' | 'Work' | 'Business' | 'Fax', required: Represents the type of a phone number - `number` string, required: Gets the phone number - `email` string, nullable: Gets the email address - `address` OcapiV1BrowsingMasterDataSitesSiteAddress: Represents the physical address of a site - `line1` string, nullable: Gets the first line - `line2` string, nullable: Gets the second line - `city` string, nullable: Gets the city - `addressV2` OcapiV1BrowsingMasterDataSitesSiteAddressV2, required: Represents the physical address of a site - `line1` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line2` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line3` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line4` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `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 - `languageTag` string, required: Gets the IETF (RFC 4646) language tag that the translation Text has been translated for - `text` string, required: Gets the translated text - `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 - `languageTag` string, required: Gets the IETF (RFC 4646) language tag that the translation Text has been translated for - `text` string, required: Gets the translated text - `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 - `type` 'Home' | 'Mobile' | 'Work' | 'Business' | 'Fax', required: Represents the type of a phone number - `number` string, required: Gets the phone number - `email` string, nullable: Gets the email address - `address` OcapiV1BrowsingMasterDataSitesSiteAddress: Represents the physical address of a site - `line1` string, nullable: Gets the first line - `line2` string, nullable: Gets the second line - `city` string, nullable: Gets the city - `addressV2` OcapiV1BrowsingMasterDataSitesSiteAddressV2, required: Represents the physical address of a site - `line1` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line2` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line3` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `line4` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - … - `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`: Site does not exist. ## Changes - **2026-10-09** `41415d239083`: 2 warning, 4 info - added the new `DiningLocationDelivery` enum value to the `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 `relatedData/allOf[subschema #1: SiteItemAvailabilityListRelatedData]/site/oneOf[subschema #2: Site]/allowedItemDeliveryMethods/items/` response property for the response status `200` - added the optional property `siteOrderLocationId` to the response with the `200` status - added the required property `isDefault` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/vista/apis/vista-digital-platform/changes/ocapi/v1/sites/:siteId/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)