Gets a list of showtime entities for a business date

Digital Platform

Getting Started

Orders

Seating

Loyalty

Subscriptions

Payments

Completed Orders

API Reference

Vista Digital Platform

Completed Order Assets

Completed Orders Assets

Completed Orders

Seats

Discounts

Events

Showtimes

get

Gets a list of showtime entities for an event

get

Gets a list of showtime entities for a film

put

Sets the requested tickets and/or seats for an order showtime within an in progress standard order

get

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

get

Gets a list of showtime entities for a business date

get

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

get

Gets a showtime by its unique identifier

Films

Gift Cards

Items

Journeys

Third Party Passes

Loyalty

Authentication

Members

Friends

Password Reset

Payments

Subscriptions

Ticket Redemption Cards

Credentials

Watched Films

Watchlist Films

BookingFees

Completion

Orders

Gift shop

Vouchers

Refunds

Seating

Sites

3rd Party Member Schemes

Ticket Prices

Tracking Events

Tips

Gets a list of showtime entities for a business date

Returns an empty list of showtime entities if no showtimes are scheduled.

Licenses Required

Vista.Ocapi

Request

path Parameters

businessDate

required

string <date-time>

Date of requested showtimes in 'yyyy-MM-dd' format

query Parameters

siteIds	Array of strings Site filter
filmIds	Array of strings Film filter

header Parameters

Connect-Region-Code

string

Region Code

Responses

200

Success

400

One or more of the provided sites or films do not exist.

get/ocapi/v1/showtimes/by-business-date/{businessDate}

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"showtimes": [{"id": "string",
"schedule": {"businessDate": "2019-08-24T14:15:22Z",
"startsAt": "2019-08-24T14:15:22Z",
"endsAt": "2019-08-24T14:15:22Z",
"filmStartsAt": "2019-08-24T14:15:22Z",
"filmEndsAt": "2019-08-24T14:15:22Z",
"inSeatItemDelivery": {"startsAt": "2019-08-24T14:15:22Z",
"endsAt": "2019-08-24T14:15:22Z"
}
},
"isSoldOut": true,
"seatLayoutId": "string",
"filmId": "string",
"siteId": "string",
"screenId": "string",
"areaCategories": [{"areaCategoryId": "string",
"isAllocatedSeating": true
}
],
"attributeIds": ["string"
],
"isAllocatedSeating": true,
"requires3dGlasses": true,
"eventId": "string",
"restrictions": ["FilmAdvanceBookingRule"
],
"filmAdvanceBookingRuleId": "string"
}
],
"relatedData": {"sites": [{"location": {"latitude": 0.1,
"longitude": 0.1
},
"contactDetails": {"phoneNumbers": [{"type": "Home",
"number": "string"
}
],
"email": "string",
"address": {"line1": "60 Khyber Pass Road",
"line2": "Grafton",
"city": "Auckland 1023"
}
},
"ianaTimeZoneName": "America/New_York",
"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"hasSellableItems": true,
"allowedItemDeliveryMethods": ["CounterPickup"
]
}
],
"films": [{"id": "string",
"title": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"synopsis": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"shortSynopsis": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"censorRatingId": "string",
"censorRatingNote": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"releaseDate": "2019-08-24T14:15:22Z",
"runtimeInMinutes": 0,
"trailerUrl": "http://example.com",
"displayPriority": 0,
"castAndCrew": [{"castAndCrewMemberId": "string",
"roles": ["Actor"
]
}
],
"genreIds": ["string"
],
"externalIds": {"moviexchangeReleaseId": "6ce6697a-16c1-46a9-acef-0a6ce948a353",
"corporateId": "string"
},
"hopk": "string",
"hoCode": "string",
"eventId": "string",
"distributorName": "string"
}
],
"castAndCrew": [{"id": "string",
"name": {"givenName": "string",
"familyName": "string",
"middleName": "string"
}
}
],
"genres": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"description": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"censorRatings": [{"id": "string",
"classification": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"classificationDescription": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"ageRestriction": {"minimumAge": 0
}
}
],
"attributes": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"shortName": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"description": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"importantMessage": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"displayPriority": 0,
"isPromoted": true
}
],
"screens": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"events": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"shortName": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"description": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"schedule": {"startDate": "2019-08-24T14:15:22Z",
"endDate": "2019-08-24T14:15:22Z"
},
"siteIds": ["string"
]
}
],
"filmAdvanceBookingRules": [{"id": "string",
"filmId": "string",
"siteId": "string",
"bookingPeriods": [{"startsAt": "2019-08-24T14:15:22Z",
"orderBookingModes": ["Paid"
],
"restriction": "None",
"rewardId": 0
}
]
}
],
"areaCategories": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"hopk": "string",
"isAllocatedSeating": true,
"isInSeatItemDeliveryAvailable": true
}
]
},
"businessDate": "2019-08-24T14:15:22Z"
}