--- title: "Gets a list of showtime entities for an event" method: GET path: "/ocapi/v1/events/{eventId}/showtimes" tags: ["Showtimes"] --- # Gets a list of showtime entities for an event `GET /ocapi/v1/events/{eventId}/showtimes` ## 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/events/{eventId}/showtimes` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) #### Licenses Required - Vista.Ocapi ## Path parameters - `eventId` string, required ## Query parameters - `siteIds` string[] ## Headers - `Connect-Region-Code` string ## Response `200` Success - OcapiV1BrowsingMasterDataShowtimesEventShowtimeListDetails: Represents a list of showtime entities for a particular event, and their related data - `eventId` string, required: Gets the unique identifier of the event - `showtimes` OcapiV1BrowsingMasterDataShowtimesShowtime[], required: Gets the list of showtime entities - `id` string, required: Gets the unique identifier - `schedule` OcapiV1BrowsingMasterDataShowtimesShowtimeSchedule, required: Represents the dates and times relevant to a showtime, e.g. its start, end, film start, etc - `businessDate` string, date-time, required: Gets the showtime entity's business date - `startsAt` string, date-time, required: Gets the date and time that the showtime starts - `endsAt` string, date-time, required: Gets the date and time that the showtime ends - `filmStartsAt` string, date-time, required: Gets the date and time that the film screening starts - `filmEndsAt` string, date-time, required: Gets the date and time that the film screening ends - `inSeatItemDelivery` OcapiV1BrowsingMasterDataShowtimesShowtimeInSeatItemDeliverySchedule: Represents when in-seat item delivery is available for a showtime - `startsAt` string, date-time, required: Gets the date and time when in-seat item delivery becomes available - `endsAt` string, date-time, required: Gets the date and time when in-seat item delivery is no longer available - `isSoldOut` boolean, required: Gets a value indicating whether the showtime is currently sold out - `seatLayoutId` string, required: Gets the unique identifier of the seat layout of the screen - `filmId` string, required: Gets the unique identifier of the film that is being screened - `siteId` string, required: Gets the unique identifier of the site that is screening the film - `screenId` string, required: Gets the unique identifier of the screen that the film will be played on - `areaCategories` OcapiV1BrowsingMasterDataShowtimesShowtimeAreaCategory[], required: Gets the list of showtime area category entities - `areaCategoryId` string, required: Gets the unique identifier of the area category entity - `isAllocatedSeating` boolean, required: Gets a value indicating whether the seat entities are allocated - `attributeIds` string[], required: Gets the list of unique identifiers of the assigned attribute entities - `isAllocatedSeating` boolean, required: Gets a value indicating whether the seat entities are allocated - `requires3dGlasses` boolean, required: Gets a value indicating whether this showtime requires 3D glasses to be viewed - `eventId` string, nullable: Gets the unique identifier of the event the showtime is assigned to, if applicable - `restrictions` OcapiV1BrowsingMasterDataShowtimesShowtimeRestriction[], required: Gets the list of restrictions that apply - `filmAdvanceBookingRuleId` string, nullable: Gets the unique identifier of the film advance booking rule that the showtime is restricted to - `inSeatItemDeliveryFee` union: Represents the base properties of an item delivery fee - OcapiV1SalesMasterDataItemsDeliveryFeesItemDeliveryFeeFixedPrice: Represents an item delivery fee base that is a fixed price - `type` 'FixedPrice' | 'Percentage', required: Represents the type of delivery fee for an item delivery fee base - `price` OcapiV1MonetaryValue, required: Represents a monetary value, and its related tax value - `valueIncludingTax` number, double, required: Gets the monetary value including tax - `valueExcludingTax` number, double, required: Gets the monetary value excluding tax - `tax` number, double, required: Gets the amount of tax - OcapiV1SalesMasterDataItemsDeliveryFeesItemDeliveryFeePercentage: Represents an item delivery fee base that is based on a percentage of the overall item delivery price - `type` 'FixedPrice' | 'Percentage', required: Represents the type of delivery fee for an item delivery fee base - `percentage` number, double, required: Gets the percentage - `salesTaxId` string, required: Gets the identifier of the sales tax - `relatedData` OcapiV1BrowsingMasterDataShowtimesEventShowtimeListRelatedData, required: Related data for a list of showtime entities for a particular event - `event` OcapiV1BrowsingMasterDataEventsEvent, required: Represents an occasion for which films can be screened and marketed together, e.g. an annual film festival - `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 - `shortName` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `description` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `schedule` OcapiV1BrowsingMasterDataEventsEventSchedule, required: Represents the start and/or end date of an event - `startDate` string, date-time, nullable: Gets the start date, if applicable - `endDate` string, date-time, nullable: Gets the end date, if applicable - `siteIds` string[], required: Gets the list of unique identifiers of the site entities screening the event - `sites` union[], required: Gets the list of related site entities - union: 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 - `films` OcapiV1BrowsingMasterDataFilmsFilm[], required: Gets the list of related film entities - `id` string, required: Gets the unique identifier - `title` 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 - `synopsis` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `shortSynopsis` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `censorRatingId` string, nullable: Gets the unique identifier of the censor rating, if applicable - `censorRatingNote` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `releaseDate` string, date-time, required: Gets the release date of the film - `runtimeInMinutes` integer, required: Gets the runtime duration in minutes - `trailers` OcapiV1BrowsingMasterDataFilmsFilmTrailer[], required: Gets the list of film trailer entities - `provider` 'Moviexchange' | 'External', required: Represents the provider of a film trailer - `uri` string, uri, required: Gets the address used for retrieving the trailer - `trailerUrl` string, uri, nullable: Gets the trailer video URL - `displayPriority` integer, required: Gets the display priority used for sorting - `castAndCrew` OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles[], required - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - `roles` OcapiV1BrowsingMasterDataCastAndCrewMembersCastAndCrewMemberRole[], required: Gets the list of roles - `actors` union[], required: Gets the list of film cast and crew member entities that acted in the film, sorted by billing order - union: Represents a cast and crew member in the context of a particular film - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMember: Represents a cast and crew member in the context of a particular film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles: Represents a film cast and crew member with the list of roles they play in the creation of a film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - `roles` OcapiV1BrowsingMasterDataCastAndCrewMembersCastAndCrewMemberRole[], required: Gets the list of roles - `directors` union[], required: Gets the list of film cast and crew member entities that directed the film, sorted by billing order - union: Represents a cast and crew member in the context of a particular film - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMember: Represents a cast and crew member in the context of a particular film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles: Represents a film cast and crew member with the list of roles they play in the creation of a film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - `roles` OcapiV1BrowsingMasterDataCastAndCrewMembersCastAndCrewMemberRole[], required: Gets the list of roles - `producers` union[], required: Gets the list of film cast and crew member entities that produced the film, sorted by billing order - union: Represents a cast and crew member in the context of a particular film - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMember: Represents a cast and crew member in the context of a particular film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles: Represents a film cast and crew member with the list of roles they play in the creation of a film - `castAndCrewMemberId` string, required: Gets the unique identifier of the cast and crew member - `roles` OcapiV1BrowsingMasterDataCastAndCrewMembersCastAndCrewMemberRole[], required: Gets the list of roles - `genreIds` string[], required: Gets the list of unique identifiers of the assigned genre entities - `externalIds` OcapiV1BrowsingMasterDataFilmsFilmExternalIds, required: Represents the external identifiers linked to a film - `moviexchangeReleaseId` string, uuid, nullable: Gets the unique identifier of the linked movieXchange film release entity - `corporateId` string, nullable: Gets the unique corporate identifier - `hopk` string, nullable: Gets the Head Office primary key - `hoCode` string, required: Gets the Head Office code - `eventId` string, nullable: Gets the unique identifier of the event the film is assigned to, if applicable - `distributorName` string, required: Gets the name of the distributor - `castAndCrew` OcapiV1BrowsingMasterDataCastAndCrewMembersCastAndCrewMember[], required: Gets the list of related cast and crew member entities - `id` string, required: Gets the unique identifier - `name` OcapiV1PersonName, required: Represents the parts of a person's name - `givenName` string, nullable: Gets the given name - `familyName` string, nullable: Gets the family name - `middleName` string, nullable: Gets the middle or any additional name - `genres` OcapiV1BrowsingMasterDataGenresGenre[], required: Gets the list of related genre 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 - `description` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `censorRatings` OcapiV1BrowsingMasterDataCensorRatingsCensorRating[], required: Gets the list of related censor rating entities - `id` string, required: Gets the unique identifier - `classification` 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 - `classificationDescription` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `ageRestriction` OcapiV1BrowsingMasterDataCensorRatingsCensorRatingAgeRestriction: Represents the age restriction of a censor rating - `minimumAge` integer, required: Gets the minimum age required - `attributes` OcapiV1BrowsingMasterDataAttributesAttribute[], required: Gets the list of related attribute 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 - `shortName` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `description` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `importantMessage` OcapiV1Translatable: Represents some customer-visible translatable Text in the default language, and a list of translation entities - `text` string, required: Gets the text in the default language - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages - `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 - `displayPriority` integer, required: Gets the display priority used for sorting - `isPromoted` boolean, required: Gets a value indicating whether the attribute should be displayed with prominence - `screens` OcapiV1BrowsingMasterDataScreensScreen[], required: Gets the list of related 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 - `filmAdvanceBookingRules` OcapiV1BrowsingMasterDataFilmAdvanceBookingsFilmAdvanceBookingRule[], required: Gets the list of related film advance booking rule entities - `id` string, required: Gets the unique identifier - `filmId` string, required: Gets the unique identifier of the film - `siteId` string, required: Gets the unique identifier of the site - `bookingPeriods` OcapiV1BrowsingMasterDataFilmAdvanceBookingsFilmAdvanceBookingPeriod[], required: Gets the list of film advance booking period entities - `startsAt` string, date-time, required: Gets the date and time that the booking period starts - `orderBookingModes` OcapiV1OrdersBookingsOrderBookingMode[], required: Gets the order booking modes that the booking period applies to - `restriction` 'None' | 'MemberReward', required: Represents the restriction options for a film advance booking period - `rewardId` integer, nullable: Gets the unique identifier of the reward that the booking period is restricted to - `areaCategories` OcapiV1SeatingMasterDataAreaCategory[], required: Gets the list of related area category 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 - `hopk` string, nullable: Gets the Head Office primary key - `isAllocatedSeating` boolean, required: Gets a value indicating whether the seat entities are allocated - `isInSeatItemDeliveryAvailable` boolean, required: Gets a value indicating whether in-seat item delivery is available for seats belonging to this area category - `salesTaxes` OcapiV1SalesMasterDataTaxSalesTax[], required: Gets the list of related sales tax entities - `id` string, required: Gets the unique identifier - `level1` union, required: Represents a tax level of a sales tax - OcapiV1SalesMasterDataTaxSalesTaxLevelFixedPrice: Represents a fixed monetary value sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `price` number, double, required: Gets the value of the fixed tax price, e.g. 5.00 to represent $5.00 - OcapiV1SalesMasterDataTaxSalesTaxLevelPercentage: Represents a percentage based sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `percentage` number, double, required: Gets the percentage - `level2` union, required: Represents a tax level of a sales tax - OcapiV1SalesMasterDataTaxSalesTaxLevelFixedPrice: Represents a fixed monetary value sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `price` number, double, required: Gets the value of the fixed tax price, e.g. 5.00 to represent $5.00 - OcapiV1SalesMasterDataTaxSalesTaxLevelPercentage: Represents a percentage based sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `percentage` number, double, required: Gets the percentage - `level3` union, required: Represents a tax level of a sales tax - OcapiV1SalesMasterDataTaxSalesTaxLevelFixedPrice: Represents a fixed monetary value sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `price` number, double, required: Gets the value of the fixed tax price, e.g. 5.00 to represent $5.00 - OcapiV1SalesMasterDataTaxSalesTaxLevelPercentage: Represents a percentage based sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `percentage` number, double, required: Gets the percentage - `level4` union, required: Represents a tax level of a sales tax - OcapiV1SalesMasterDataTaxSalesTaxLevelFixedPrice: Represents a fixed monetary value sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `price` number, double, required: Gets the value of the fixed tax price, e.g. 5.00 to represent $5.00 - OcapiV1SalesMasterDataTaxSalesTaxLevelPercentage: Represents a percentage based sales tax level base - `type` 'FixedPrice' | 'Percentage', required: Discriminator for various types of sales tax level base entities - `percentage` number, double, required: Gets the percentage ## Other responses - `400`: One or more of the provided sites do not exist. - `404`: Event does not exist. ## Changes - **2026-10-09** `41415d239083`: 2 warning, 4 info - added the new `DiningLocationDelivery` enum value to the `relatedData/allOf[subschema #1: EventShowtimeListRelatedData]/sites/items/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: EventShowtimeListRelatedData]/sites/items/oneOf[subschema #2: Site]/allowedItemDeliveryMethods/items/` response property for the response status `200` - added the optional property `showtimes/items/inSeatItemDeliveryFee` to the response with the `200` status - added the required property `relatedData/allOf[subschema #1: EventShowtimeListRelatedData]/salesTaxes` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/vista/apis/vista-digital-platform/changes/ocapi/v1/events/:eventId/showtimes/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)