Error Handling

Depending on the product, Tiqets may be the source of truth for availability, pricing, and tickets. For other products, Tiqets is connected to upstream services, each of which have their own way of returning errors. We invest considerable time and effort in categorising the various upstream errors and grouping them into a limited set of errors for our Distributors to handle.

Error Messages

When something goes wrong, we will return an error response containing an error code, for example:

{
  "success": false,
  "error_code": "validation_error",
  "message": "Validation error.",
  "field_errors": {
  "payment_confirmation_token": "Invalid payment confirmation token."
  }
}

Refer to the following table for the meaning of each error and what to do when you receive it.

Error Code	HTTP Status	Meaning	What to do
not_found	404	The requested resource was not found.	Verify that the URL and the provided IDs are correct.
checkout_disabled	400	Checkout is temporarily disabled for this product. This usually means there is a problem with the venue or the ticket supplier. The response contains a field called reason that explains why the checkout of the product is disabled. This depends on the reason why the checkout of the product is disabled.	For this error code, the response includes a field called reason that explains why the checkout is disabled. Sometimes, retrying after some time may help but this depends on the value of this field. For example, if the reason is "Product out of season", then retrying is not necessary.
payload_decode_error	400	The payload could not be decoded.	The payload is not signed, or it's signed using the wrong key or using the wrong algorithm, or there are other problems with the signature. Please verify how the payload is being signed.
variants_not_available	400	Some or all of the requested variants are not available.	Update the availability cache for this product.
timeslot_not_available	400	The requested timeslot is not available.	Update the availability cache for this product.
wrong_order_state	400	The requested action cannot be performed on this order at its current status.	This usually happens when trying to confirm an order that has already been confirmed, or which has expired. Please retrieve the order and check its status.
validation_error	400	There was a problem validating the data you sent. The error includes a field_errorsdictionary that specifies which fields are affected and what the issue is.	Correct the issues in the parameters being sent.
variants_max_tickets_exceeded	400	Trying to book more tickets than what is allowed for one or more variants.	Check the value for max_tickets on the variants and retry the order with several tickets for each variant which does not exceed this value.
additional_field_missing	400	Some required additional fields were not provided.	Check if all additional fields are supplied in the request body.
addon_only_submission	400	It is not possible to submit only add-ons. It's possible to order an add-on together with a product, but not standalone.	Ensure you don't create orders that only consists of add-ons
variants_unfulfilled_constraint	400	There is an unfulfilled constraint between two variants. For example a variant can only be bought when bought together with another variant.	Ensure the submitted variants can be bought together.
variants_selected_more_than_once	400	At least one variant in the request is part of the create order request more than once.	Ensure there are no duplicate variants in the request.
no_availability	400	Your request could not be handled because the resource is not available. This may be caused by a race condition if multiple clients place an order for a product with limited supply	Refresh your availability and try a different date/time.
product_access_denied	403	You are not authorized to access the product.	Please verify that you are accessing the products that were agreed to. If you need to access this product, contact Tiqets.
unauthorized_distributor	403	You are performing an operation that is not allowed.	If you need to perform this operation contact Tiqets.
unauthorized	403	Authorization failed.	Please verify that you're sending the correct API key, using the correct header.
resource_gone	410	The requested resource is not accessible anymore.	It is no longer possible to retrieve requested resource.
rate_limit_exceeded	429	You exceeded the rate limit per second.	The error includes a limitkey that specifies the limit. Please verify that you aren't refreshing the cache more often than necessary.
order_limit_exceeded	429	You exceeded the limit of orders per hour.	The error includes a limitkey that specifies the limit. Please verify that you aren't creating too many orders by mistake. Please contact Tiqets in case you reach the limit with valid orders and need to increase the threshold.
reservation_error	500	Our system encountered a problem when trying to create the order. There was no order created.	Please contact Tiqets for assistance.
temporary_error	500	There was a temporary problem in our system.	Introduce a waiting period and retry. If the problem persists, please contact Tiqets.