---
title: "Gets a list of showtime entities for today and tomorrow for a screen"
method: GET
path: "/ocapi/v1/showtimes/by-screen/{screenId}"
tags: ["Showtimes"]
---

# Gets a list of showtime entities for today and tomorrow for a screen

`GET /ocapi/v1/showtimes/by-screen/{screenId}`

This endpoint is currently used to find an in-progress or imminent showtime given a screen ID, which can
then be used as the showtime context for an in-seat delivery order.




showtime entities for the 48 hours from the beginning (i.e. 00:00) of today's calendar date
up to the end of the next calendar day are returned. This is to cater for the scenario where this endpoint
is called close to the end of the day, such that the next day's showtimes are needed as well.




showtime entities that started on the previous calendar date, but finish on today's calendar date are included.




showtime entities that do not support or are not yet available for in-seat delivery are
still included so that this can be communicated to patrons.




Unlike endpoints based on business date, the cutoff for each calendar day is always midnight.

#### Licenses Required


- Vista.Ocapi

## Path parameters

- `screenId` string, required

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- union — Represents a list of showtime entities, and their related data
  - OcapiV1BrowsingMasterDataShowtimesShowtimeBusinessDayListDetails — Represents a list of showtime entities for a particular business day, and their related data
    - `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
    - `relatedData` OcapiV1BrowsingMasterDataShowtimesShowtimeListRelatedData, required — Related data for a list of showtime entities
      - `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
              - …
            - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required — Represents the contact details 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
              - …
            - `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
              - …
            - `location` OcapiV1GeographicLocation — Represents a set of geospatial coordinates; longitude and latitude, that can be used to pinpoint a location on a map
              - …
            - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required — Represents the contact details 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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
      - `events` OcapiV1BrowsingMasterDataEventsEvent[], required — Gets the list of related event 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 — 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
      - `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
    - `businessDate` string, date-time, required — Gets the business date of the showtime entities
  - OcapiV1BrowsingMasterDataShowtimesShowtimeListDetails — Represents a list of showtime entities, and their related data
    - `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
    - `relatedData` OcapiV1BrowsingMasterDataShowtimesShowtimeListRelatedData, required — Related data for a list of showtime entities
      - `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
              - …
            - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required — Represents the contact details 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
              - …
            - `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
              - …
            - `location` OcapiV1GeographicLocation — Represents a set of geospatial coordinates; longitude and latitude, that can be used to pinpoint a location on a map
              - …
            - `contactDetails` OcapiV1BrowsingMasterDataSitesSiteContactDetails, required — Represents the contact details 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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
              - …
            - OcapiV1BrowsingMasterDataFilmsFilmCastAndCrewMemberWithRoles — Represents a film cast and crew member with the list of roles they play in the creation of a film
              - …
        - `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
      - `events` OcapiV1BrowsingMasterDataEventsEvent[], required — Gets the list of related event 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 — 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
      - `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

## Other responses

- `404` — Not Found

---

[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)
