---
title: "Gets Screening Dates"
method: GET
path: "/ocapi/v1/film-screening-dates"
tags: ["Films"]
---

# Gets Screening Dates

`GET /ocapi/v1/film-screening-dates`

Returns a list of dates that have upcoming showtimes, along with details about which films are playing at each site on each day.

#### Licenses Required


- Vista.Ocapi

## Query parameters

- `siteIds` string[]
- `filmIds` string[]

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- OcapiV1BrowsingMasterDataFilmScreeningsFilmScreeningDateListDetails — Represents a list of film screening date entities
  - `filmScreeningDates` OcapiV1BrowsingMasterDataFilmScreeningsFilmScreeningDate[], required — Gets the list of film screening date entities
    - `businessDate` string, date-time, required — Gets the business date
    - `filmScreenings` OcapiV1BrowsingMasterDataFilmScreeningsFilmScreening[], required — Gets the list of film screening entities
      - `filmId` string, required — Gets the unique identifier of the film
      - `sites` OcapiV1BrowsingMasterDataFilmScreeningsFilmScreeningSite[], required — Gets the list of film screening site entities
        - `siteId` string, required — Gets the unique identifier of the site
        - `showtimeAttributeIds` string[], required — Gets the list of unique identifiers of the attribute entities being screened

## Other responses

- `400` — One or more of the provided sites or films do 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)