---
title: "Gets a list of event entities"
method: GET
path: "/ocapi/v1/events"
tags: ["Events"]
---

# Gets a list of event entities

`GET /ocapi/v1/events`

Only Head Office defined events are returned.
#### Licenses Required


- Vista.Ocapi

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- OcapiV1BrowsingMasterDataEventsEventListDetails — Represents a list of event entities and their related data
  - `events` OcapiV1BrowsingMasterDataEventsEvent[], required — Gets the list of 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
  - `relatedData` OcapiV1BrowsingMasterDataEventsEventListRelatedData, required — Related data for a list of event 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
            - `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
              - …
          - `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
              - …
          - `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

---

[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/versions/3a81c0aed14e/schema)