v1

latestOpenAPI 3.0.12026-08-06135498863.0 KB

Showtimes

Gets a list of showtime entities for a film

Returns an empty list of showtime entities if no showtimes are scheduled for that film

There is a maximum of 5 site identifiers to be passed into the siteIds parameter.

Licenses Required

Vista.Ocapi

get/ocapi/v1/films/{filmId}/showtimes

Path parameters

filmIdstring required

The film identifier of the requested showtimes

Query parameters

siteIdsstring[]

The site filter

Headers

Connect-Region-Codestring

Region Code

Response

Success

filmIdstring required

Example response

{
  "relatedData": {
    "film": {
      "title": {
        "translations": [
          {
            "languageTag": "en-US"
          }
        ]
      },
      "synopsis": {
        "translations": [
          {
            "languageTag": "en-US"
          }
        ]
      },
      "shortSynopsis": {
        "translations": [
          {
            "languageTag": "en-US"
          }
        ]
      },
      "censorRatingNote": {
        "translations": [
          {
            "languageTag": "en-US"
          }
        ]
      }
    },
    "sites": [
      {
        "contactDetails": {
          "address": {
            "line1": "60 Khyber Pass Road",
            "line2": "Grafton",
            "city": "Auckland 1023"
          }
        },
        "ianaTimeZoneName": "America/New_York",
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "events": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "shortName": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "description": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "genres": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "description": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "censorRatings": [
      {
        "classification": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "classificationDescription": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "attributes": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "shortName": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "description": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "importantMessage": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "screens": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "areaCategories": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ]
  }
}