Error codes
Internal errors
An exception raised by the MX API itself.
Error code range: 10,000 – 19,999
HTTP response code: 500 Internal Server Error
Timeouts / connectivity issues
External Component Access Errors and Timeouts – e.g.: a failure to reach a Cinema's ticketing service. May be temporary and therefore resolvable by retrying at a later time.
Error code range: 20,000 – 29,999
HTTP response code: 504 Gateway timeout
Unexpected cinema ticketing service errors
An unexpected exception raised by a Cinema’s ticketing service
Error code range: 30,000 – 39,999
HTTP response code: 502 Bad Gateway
Business rule errors
An exception raised by a Cinema’s ticketing service as a result of a business rule (or similar)
Error code range: 40,000 – 49,999
HTTP response code: 400 Bad Request
| Error Code | Description |
|---|---|
| 10000 – Unexpected Error | An unexpected error/database error/component error has occurred |
| 10002 – Authorisation Exception | An internal error occurred while trying to authorise the request |
| 10003 – Vendor Configuration Exception | There's a configuration issue with the authenticated vendor |
| 20000 – Cinema Ticket Service Access Error | Unable to reach the cinema’s ticketing service |
| 20001 – Cinema Ticketing Service Timeout | Cinema’s ticketing service failed to respond in a timely manner |
| 20002 – Can’t Connect to Site | The Cinema’s ticketing service failed to connect to the specified site |
| 20003 – Can’t Connect to Loyalty | The cinema’s ticketing service failed to connect to its loyalty system |
| 30000 – Unexpected Cinema Ticketing Service Error | An unexpected error occurred at the cinema’s ticketing service |
| 30001 – Failed to retrieve seats for order | Seats were booked, but an unexpected error occurred while trying to retrieve seat information. Try to retrieve the order again |
| 30002 – Failed to process order value | An unexpected error occurred while trying to calculate the order total. The order was cancelled |
| 30003 – Refund booking failed | The cinema's ticketing service was unable to refund this booking. |
| 30004 – Invalid response | The cinema's ticketing service returned an invalid response |
| 31001 – Cinema ticketing service configuration error | The cinema’s ticketing service has not been correctly configured with the MX Transactional API |
| 31002 – Cinema ticketing service site not found | A site existing in the MX Transactional API does not exist at cinema |
| 32001 – Booking Fee Configuration Error | There’s a problem with the cinema’s ticketing service booking fee configuration |
| 32002 – Payment configuration error | There’s a problem with the cinema’s ticketing service payment configuration |
| 32003 - Unable to confirm if loyalty card is valid | Unable to confirm if the supplied loyalty card number is valid |
| 32004 - Invalid request for adding items to the order | Invalid request for adding items to the order |
| 40001 – Cinema chain not found | The requested cinema chain cannot be found |
| 40002 – Site not found | The specified site cannot be found |
| 40003 – Showtime not found | The specified Showtime cannot be found |
| 40004 – Ticket types mandatory | The client must provide the ticket types for the request. |
| 40005 – Concessions not supported | An attempt to purchase concessions was made, but Concessions are not supported in the API |
| 40006 – Seating unavailable because Showtime is not allocated seating | An attempt to get screen layout was made, however, the Showtime is not configured to be seat-allocated |
| 40007 – Total payment amount is insufficient | The total payment amount specified doesn’t match the order total |
| 40008 – Multi site order not supported | A single order cannot contain sessions or items at more than one site |
| 40009 – Order does not exist | Could not find an order with the specified ID |
| 40010 - Seat map requested for sold out showtime | Seat map data was requested for a showtime that is already sold out |
| 40011 – Ticket type not found | The requested ticket type was not found for the showtime |
| 40012 – Request too large | The request was too large |
| 40013 – Customer Details not Set | Customer details were not set for the order |
| 40014 – Vendor Access Not Allowed | You have no access to the Cinema Chain requested |
| 40015 – Refunds for past screenings not allowed | Cannot refund a booking when one or more tickets that are part of the booking are for screenings that have already screened |
| 40016 – Refunds not allowed for cinema chain | The cinema chain does not allow refunds |
| 40017 – Booking belongs to another vendor | Cannot refund a booking made through a different vendor |
| 40018 – Insufficient customer details | An email, name and/or phone number must be provided. |
| 40019 – Loyalty not allowed for cinema chain | The cinema chain does not allow loyalty |
| 40020 – Insufficient loyalty membership details | Insufficient loyalty membership details |
| 40021 – Ticket types not available for past screenings. | Ticket types not available for past screenings |
| 40022 - Showtime is no longer available for sale | Showtime is no longer available for sale |
| 40023 - Showtime provided is not from the cinema chain provided | Showtime provided is not from the cinema chain provided |
| 40024 - The site exists but is not active | The site exists but is not active |
| 40025 - The booking does not have the specified line item | The booking does not have the specified ticket line item |
| 40026 - Order must contain at least one ticket | Order must contain at least one ticket |
| 40027 - Items not allowed for the cinema chain | Items not allowed for the cinema chain |
| 40028 - Item access is not allowed for the vendor | Item access is not allowed for the vendor |
| 40029 - Cannot add items with no quanity | Incorrect quantity specified for item or modifier |
| 40030 - Ticket types are not yet available for the showtime. | Ticket types are not yet available for the showtime. |
| 40031 – Cannot swap seats for showtimes that have already screened. | Cannot swap seats for showtimes that have already screened |
| 40032 – The cinema chain does not allow seat swaps | The cinema chain does not allow seat swaps |
| 40033 - The requested seats do not exist. | The requested seats do not exist. |
| 40034 - Cinema chain does not support feature | The cinema chain does not support the requested feature |
| 40039 - Items only orders not allowed for cinema chain | Items only orders not allowed for the cinema chain |
| 40040 - Items only orders not allowed for vendor | Items only orders are not allowed for the vendor |
| 40041 - Order must contain tickets or items | Order must contain at least one ticket or one item |
| 40042 - Item not found | Item not found |
| 40043 - Item modifiers not allowed for cinema chain | Item modifiers not allowed for the cinema chain |
| 40044 - Item modifier not found | Item modifier not found |
| 40045 - Items not found | Items not found for this cinema chain |
| 41001 – Seats unavailable | The requested seats are not available |
| 41002 – No contiguous seats | The selected seats could not be automatically allocated in a single row |
| 41003 – Booking does not exist | A booking with the specified ID does not exist |
| 41004 – Booking already cancelled | The specified booking has already been cancelled |
| 41005 – Showtime Unavailable | The requested showtime is not available at the cinema’s ticketing service |
| 41006 – Ticket not for sale | Selected tickets are not currently for sale for this showtime |
| 41007 – Selected seats invalid for the ticket | Selected seats are not valid for the tickets in the order |
| 41008 – Order already being completed | A request to complete the order was already made and is currently in progress. |
| 41009 – Order cannot be uniquely identified | The cinema's ticketing service was not able to identify the requested order |
| 41010 – Could not get ticket types for the session | Could not get ticket types for the requested session. Please make sure the session is still available |
| 41011 – Loyalty member not found | Loyalty member could not be found. |
| 41012 - Failed to add all tickets to order. Please get the order again to see its status. | Failed to add all tickets to order. Please get the order again to see its status. |
| 41013 - Failed to remove all specified tickets from order. Please get the order again to see its status. | Failed to remove all specified tickets from order. Please get the order again to see its status. |
| 41014 - Failed to add all specified payments to order. Please get the order again to see its status. | Failed to add all specified payments to order. Please get the order again to see its status. |
| 41015 - Failed to select all seats for the order. Please get the order again to see its status. | Failed to select all seats for the order. Please get the order again to see its status. |
| 41016 - All items in booking should be from only one site | All items in booking can only be from one site |
| 41017 - A requested line item has already been collected | A requested line item has already been collected |
| 41018 - A requested line item has already been collected | A requested line item has already been refunded |
| 41019 - A refund request has been throttled | A refund request has been throttled |
| 41020 – Seat Swaps for multiple showtimes not supported | Cinema chain does not support swapping seats for multiple showtimes in a single request |