Errors
We indicate the type of API error that occured in two ways:
- HTTP status codes.
- Unique Error Codes. If a situation occurs that you are expected to be able to react to with more precision than HTTP status codes would allow, we will return a unique error code in the response body as well.
Example Error Body
Our error responses always have the following JSON structure:
1 { 2 "code": "generic_error", 3 "message": "Http method OPTIONS is not supported." 4 }
HTTP Error Status Codes
The following HTTP status error codes are used in our API:
| Status Code | Description |
|---|---|
| 400 | Bad Request: The request could not be understood by the server. |
| 401 | Unauthorized: Authentication is required and has failed or has not yet been provided. |
| 403 | Forbidden: The server understood the request but refuses to authorize it. |
| 404 | Not Found: The requested resource could not be found. |
| 405 | Method Not Allowed: The request method is not supported for the requested resource. |
| 408 | Request Timeout: The server timed out waiting for the request. |
| 409 | Conflict: The request could not be completed due to a conflict with the current state of the resource. |
| 410 | Gone: The resource requested is no longer available and will not be available again. |
| 413 | Payload Too Large: The request is larger than the server is willing or able to process. |
| 415 | Unsupported Media Type: The request entity has a media type which the server or resource does not support. |
| 416 | Range Not Satisfiable: The server cannot provide the requested range of data. |
| 422 | Unprocessable Entity: The server understands the request, but could not succeed in processing it. |
| 429 | Too Many Requests: Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
| 500 | Internal Server Error: The server encountered an unexpected condition that prevented it from fulfilling the request. |
| 501 | Not Implemented: The server does not support the functionality required to fulfill the request. |
| 502 | Bad Gateway: The server received an invalid response from an upstream server. |
| 503 | Service Unavailable: The server is currently unable to handle the request due to temporary overloading or maintenance. |
| 504 | Gateway Timeout: The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server. |
| 505 | HTTP Version Not Supported: The server does not support the HTTP protocol version that was used in the request. |
Unique Error Codes
The following unique error codes are used in our API:
| Error Code | Description |
|---|---|
generic_error | An error occurred. See HTTP status code. |
saas_tenant_not_found | Provided tenant GUID (parameter tenant) is not a valid tenant ID. |
saas_environment_not_found | Provided tenant environment name (parameter environment) is not a valid environment name for the selected tenant. |
saas_company_not_found | Provided company name (parameter company) is not a valid company name for the selected tenant and environment. |
server_timeout | The server timed out while processing the request. |
unsupported_http_method | The http method is not supported for this endpoint. |
resource_not_found | The selected resource does not exist. |
globalsale_duplicate_key | Duplicate key. |
capacity_exceeded | The capacity has been exceeded. Entry is not allowed. |
invalid_reference | The reference is invalid. |
reservation_not_found | The required reservation for the ticket was not found. |
not_valid | The ticket is not valid. |
reservation_mismatch | Your reservation is not for the current event. |
admission_not_open | The admission code is not open. |
admission_not_open_entry | The admission code is not open for this entry. |
not_confirmed | The ticket has not been confirmed. |
reservation_not_for_today | The reservation is not valid for today. |
reservation_capacity_exceeded | The reservation capacity has been exceeded. |
ticket_canceled | The ticket has been canceled. |
ticket_not_valid_yet | The ticket is not valid yet. |
ticket_expired | The ticket has expired. |
quantity_change_not_allowed | The quantity change is not allowed. |
no_default_schedule | No default schedule could be found. |
missing_payment | The ticket is missing a payment transaction. |
schedule_entry_expired | The schedule entry has expired. |
reservation_not_for_now | The reservation is not valid for now. |
concurrent_capacity_exceeded | The concurrent capacity has been exceeded. |
reschedule_not_allowed | Rescheduling is not allowed. |
invalid_admission_code | The admission code is invalid. |
has_payment | The ticket has already been paid. |
duration_exceeded | The admission duration has expired. |
ticket_blocked | The ticket is blocked. |
ticket_not_valid_for_suggested_admission | The ticket is not valid for the suggested admission. |
ticket_not_allowed | The ticket is not allowed since no valid admission code could be found. |
wallet_expired | The wallet has expired. |
ticket_reservation_has_no_tickets | The ticket reservation has no tickets. |
member_blocked | Member is blocked. |
member_card_blocked | Member card is blocked. |
member_card_not_allowed | Member card is not allowed. |
member_card_expired | Member card has expired. |
membership_setup_missing_ticket_item | Membership setup is missing ticket item. |
membership_setup_missing | Membership setup is missing. |
membership_blocked | Membership is blocked |
member_unique_id_violation | Member with same unique id already exists. |
member_count_exceeded | Member count exceeded. |
member_card_exists | Member card already exists. |
no_admin_member | No admin member found. |
member_card_blank | Member card is blank. |
invalid_contact | The provided contact number is not valid in context of the customer. |
age_verification_setup | Add member failed on age verification because item number for sales was not provided. |
age_verification | Age verification failed. |
allow_member_merge_not_set | This request violates the community’s member identity uniqueness rule. See the API documentation for merge options. |
member_card_limitation_error | Limitations on member card apply and deny admission. |
denied_by_speedgate | The reference number was denied by the gate. |
scanner_not_found | The scanner was not found. |
scanner_id_required | The scanner id is required. |
scanner_not_enabled | The scanner is not enabled. |
number_not_whitelisted | The reference number was not whitelisted by the gate. |
number_rejected | The reference number was actively rejected by gate setup. |