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

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 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

Request

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

204

No showtimes scheduled.

get/ocapi/v1/showtimes/by-business-date/first

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"
}