VIvista
Showtimes

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

Changed on

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
get/ocapi/v1/showtimes/by-screen/{screenId}

Request

Path parameters

screenIdstring required

The unique identifier of the screen

Headers

Connect-Region-Codestring

Region Code

Response

Success

OR

Changes

  • 41415d239083Revision changes
    • warning

      added the new DiningLocationDelivery enum value to the /////// response property for the response status

    • warning

      added the new DiningLocationDelivery enum value to the /////// response property for the response status

    • warning

      added the new DiningLocationDelivery enum value to the /////// response property for the response status

    • warning

      added the new DiningLocationDelivery enum value to the /////// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property //////// to the response with the status

    • info

      added the required property //////// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property //////// to the response with the status

    • info

      added the required property //////// to the response with the status