--- title: "Gets a showtime by its unique identifier" method: GET path: "/ocapi/v1/showtimes/{showtimeId}" tags: ["Showtimes"] --- # Gets a showtime by its unique identifier `GET /ocapi/v1/showtimes/{showtimeId}` #### Licenses Required - Vista.Ocapi ## Path parameters - `showtimeId` string, required ## Headers - `Connect-Region-Code` string ## Response `200` Success - OcapiV1BrowsingMasterDataShowtimesShowtimeDetails — Represents the details of a showtime entity, and its related data - `showtime` OcapiV1BrowsingMasterDataShowtimesShowtime, required — Represents the presentation of a film on a particular screen at a particular date and time - `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 - `relatedData` OcapiV1BrowsingMasterDataShowtimesShowtimeRelatedData, required — Related data for a showtime entity - `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 - `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 - `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 - `film` OcapiV1BrowsingMasterDataFilmsFilm, required — Represents a film entity - `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 - `screen` OcapiV1BrowsingMasterDataScreensScreen, required — Represents a room belonging to a site where film entities are screened - `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 - `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 - `censorRating` OcapiV1BrowsingMasterDataCensorRatingsCensorRating — Represents the censor rating of a film, e.g. R18 - `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 - `event` OcapiV1BrowsingMasterDataEventsEvent — 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 - `filmAdvanceBookingRule` OcapiV1BrowsingMasterDataFilmAdvanceBookingsFilmAdvanceBookingRule — Represents a booking period for a film advance booking rule - `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 ## Other responses - `404` — Showtime does not exist. --- [API](https://skmtc.net/vista/apis/vista-digital-platform.md) · [All operations](https://skmtc.net/vista/apis/vista-digital-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vista/vista-digital-platform/revisions/3a81c0aed14e/schema)