| | | |
| 1 – 1.5 | Dec 2016 - Mar 2017 | Initial versions in line with development |
| 1.6 | 31 Mar 2017 | RC Documentation |
| 1.7 | 10 Apr 2017 | Added intended usage note, Client ID clarification, Vista Showtime ID methods, and note about creating application-specific credentials. |
| 1.8 | 11 Apr 2017 | Corrected HTTP verb for booking cancellation request. |
| 1.9 | 13 Apr 2017 | Added Limitations and “Remove Tickets” sections. |
| 2.0 | 13 Apr 2017 | Added descriptions and examples to the API endpoints. Added error codes. |
| 2.1 | 21 Apr 2017 | Added note about setting customer details before completing order. |
| 2.2 | 28 Apr 2017 | Added note about the issuing of refresh tokens being made optional. Clarified usage of refresh tokens |
| 2.3 | 2 May 2017 | Separated MX Tickets functionality out from single movieXchange API document |
| 2.4 | 4 May 2017 | Added separate examples for credit card and non-credit card payments |
| 2.5 | 17 May 2017 | Updating error codes section |
| 2.6 | 29 May 2017 | Updated to new subdomain and introduced path in URL. Added note re. using credentials for multiple API services |
| 2.7 | 8 Jun 2017 | Added new MX-Api-Client-Secret header details |
| 2.8 | 6 Jul 2017 | Added seatsRequireSelection flag details |
| 2.9 | 13 Jul 2017 | Added further seatsRequireSelection details |
| 3.0 | 1 Aug 2017 | Booking refund API added |
| 3.1 | 10 Aug 2017 | Loyalty support – earn points for completed orders |
| 3.2 | 24 Aug 2017 | Added more seating details |
| 3.3 | 25 Sept 2017 | Corrected swagger link for Bookings |
| 3.4 | 26 Oct 2017 | Added information on bookingId and barcodes |
| 3.5 | 27 Oct 2017 | Added seat layout detail |
| 3.6 | 2 Nov 2017 | Added Correlation Id header details |
| 3.7 | 17 Nov 2017 | Fixed inconsistent quantities in the order JSON examples |
| 3.8 | 20 Dec 2017 | Added note to refund booking about supporting refunds after showtime start |
| 3.9 | 09 Jan 2018 | Added note in Create Order section about optional expirationTimeUtc field in ticketing responses |
| 3.10 | 11 Jan 2018 | Added Get Booking |
| 3.11 | 17 Jan 2018 | Added partial refunds |
| 3.12 | 30 Jan 2018 | Added concession support. Separated showtimes and concessions reference data endpoints. |
| 4.0 | 21 Feb 2018 | Renamed to MX Transactional API Guide, and added credit card number format requirement to ‘Complete Order’ |
| 4.1 | 5 Apr 2018 | Added Membership Card Validation (Loyalty Service) |
| 4.2 | 10 Apr 2018 | Updated endpoint address for Loyalty (to include v1) |
| 4.3 | 21 May 2018 | Updated example response for Get Booking to remove duplicate line items |
| 4.4 | 25 Jun 2018 | Updated collectedStatus description in Get Booking, added 30004 to error code list, added coverage of handling 504 responses and automated ‘checking and reversal’ process to ‘Complete Order’, added ‘Get Screen Layout for Showtime’ |
| 4.5 | 9 Jul 2018 | Added Seat Swap |
| 4.6 | 20 Jul 2018 | Added ‘Unavailable’ state for seats |
| 4.7 | 2 Aug 2018 | Added modifiers for order and booking endpoints |
| 4.8 | 17 Aug 2018 | Added some missing error codes |
| 4.9 | 15 Oct 2018 | Added email and phone elements to loyalty on Set Customer Details |
| 4.10 | 30 Oct 2018 | Replaced HTTP with HTTPS in all examples |
| 4.11 | 5 Dec 2018 | General review and refinement of terminology throughout |
| 4.12 | 6 Dec 2018 | Support for validating loyalty membership by email and phone number (v2 endpoint). Support for earning loyalty points using email or phone number |
| 4.13 | 17 Jan 2019 | Corrected sample request for v2 Validate Membership |
| 4.14 | 25 Jan 2019 | Added areaCategoryDescription to Get Screen Layout endpoints |
| 4.15 | 30 Jan 2019 | Added hasAssociatedLoyaltyMembership to Get Booking |
| 4.16 | 5 Feb 2019 | Added Postman collection details |
| 4.17 | 18 Feb 2019 | Added error code 40034 : Cinema Chain Does Not Support Feature |
| 4.18 | 25 Feb 2019 | Added 'Create Payment Token' endpoint |
| 4.19 | 2 Apr 2019 | Added support for creating orders with only tickets, only items or both to Create Order |
| 4.20 | 10 Apr 2019 | Added 'Extend Order Expiration' endpoint, and added canResetOrderExpiry to Get Cinema Chains |
| 4.21 | 15 May 2019 | Updated documentation of the automated cleanup of timed-out order completions in Complete Order |
| 4.22 | 7 Jun 2019 | Added support for ticket packages |
| 4.23 | 19 Aug 2019 | Added transactionId support to Complete Order and Get Booking |
| 4.24 | 29 Aug 2019 | Added support for ticket sales after the beginning of a showtime |
| 4.25 | 18 Mar 2020 | Added support for the customer's tax details to be added to an order |
| 4.26 | 26 May 2020 | Added 'Begin Item Preparation' endpoint |
| 4.27 | 03 Jun 2020 | Added support for 'Booking Notes' |
