Sign in

v1

latestOpenAPI 3.0.12026-08-06135498863.0 KB
Showtimes

Gets a list of showtime entities for the first business date with showtimes

Useful when filtering by site or film where showtimes may only be in the future.

Licenses Required

  • Vista.Ocapi
get/ocapi/v1/showtimes/by-business-date/first

Query parameters

siteIdsstring[]

Site filter

filmIdsstring[]

Film filter

Headers

Connect-Region-Codestring

Region Code

Response

Success

businessDatestring date-time required

Gets the business date of the showtime entities

Example response

{
  "relatedData": {
    "sites": [
      {
        "contactDetails": {
          "address": {
            "line1": "60 Khyber Pass Road",
            "line2": "Grafton",
            "city": "Auckland 1023"
          }
        },
        "ianaTimeZoneName": "America/New_York",
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "films": [
      {
        "title": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "synopsis": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "shortSynopsis": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "censorRatingNote": {
          "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"
            }
          ]
        }
      }
    ],
    "events": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "shortName": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        },
        "description": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ],
    "areaCategories": [
      {
        "name": {
          "translations": [
            {
              "languageTag": "en-US"
            }
          ]
        }
      }
    ]
  }
}