This document provides a comprehensive list of all error codes used in the Bookings API.
Format: RESOURCE-X-NNN
- RESOURCE: 3-5 character resource identifier (AVAIL, OPRUL, BOOK, PMAP, VENUE, USER, IDENT)
- X: Retryability indicator
R= Retryable (transient error, may succeed on retry)N= Non-retryable (permanent error, requires different input)
- NNN: 3-digit error code (001-999)
All errors follow the RFC 7807 ProblemDetails format:
{
"type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
"title": "Error Title",
"status": 400,
"detail": "Detailed error message",
"code": "RESOURCE-N-001",
"isRetryable": false
}Availability checking and product validation errors
| Code | Title | Description | Retryable |
|---|---|---|---|
AVAIL-N-001 | Product Not Found | The requested product could not be found for the specified venue | No |
AVAIL-N-002 | Venue Not Configured for Partner | The venue is not configured for access by the current partner | No |
AVAIL-N-003 | No Products Available for Partner | No products are accessible to this partner based on partner mappings | No |
AVAIL-N-004 | Venue Closed on Requested Date | The venue is closed on the requested date and cannot accept bookings | No |
AVAIL-N-005 | No Availability for Time Slot | No availability exists for the requested date and time | No |
Operator availability rule validation errors
| Code | Title | Description | Retryable |
|---|---|---|---|
OPRUL-N-001 | Specific Date Disabled | The operator has disabled availability for the requested specific date | No |
OPRUL-N-002 | Date Range Disabled | The requested date falls within a date range disabled by the operator | No |
OPRUL-N-003 | Recurring Pattern Disabled | The requested date matches a recurring pattern disabled by the operator | No |
OPRUL-N-004 | Time Range Disabled | The requested start time falls within a time range disabled by the operator | No |
OPRUL-N-005 | Availability Rule Not Found | The requested availability rule could not be found | No |
OPRUL-N-006 | Scope Value Already Exists | The value is already present in the scope collection and cannot be added again | No |
OPRUL-N-007 | Scope Entity Not Found | One or more scope values do not correspond to an existing entity for this operator | No |
OPRUL-N-008 | Product Reserved For Other | The operator has reserved the requested date/time for a different product | No |
Partner access and mapping validation errors
| Code | Title | Description | Retryable |
|---|---|---|---|
PMAP-N-001 | Venue Not Mapped to Partner | The requested venue is not mapped to the current partner | No |
PMAP-N-002 | Product Not Mapped to Partner | The requested product is not accessible to the current partner | No |
PMAP-N-003 | Partner Booking Access Denied | You do not have permission to access this booking | No |
PMAP-N-004 | Partner Not Found | The specified partner could not be found | No |
PMAP-N-005 | Product Mapping Not Found | Cannot replace: one or more products are not currently mapped to this partner | No |
PMAP-N-006 | Product Already Mapped | Cannot add: one or more products are already mapped to this partner | No |
PMAP-N-007 | Partner Source Mapping Not Found | Cannot replace: one or more partner sources are not currently mapped to this operator | No |
PMAP-N-008 | Partner Source Already Exists | A partner source with this identifier already exists for the operator | No |
Booking creation and management errors
| Code | Title | Description | Retryable |
|---|---|---|---|
BOOK-N-001 | No TMS Configurations Found | Cannot perform any research for the provided venue group. No TMS configurations found. | No |
BOOK-N-002 | Booking Already Exists | The booking already exists in the database | No |
BOOK-N-003 | TMS Configuration Not Found | No TMS configuration found for the specified composite ID | No |
BOOK-N-004 | Missing Partner Source Configuration | The partner source is not configured for this venue group and partner | No |
BOOK-N-005 | Venue Group Partner Association Not Found | No venue group and partner association found | No |
BOOK-N-006 | Booking Not Found | The requested booking could not be found | No |
BOOK-N-007 | Preorder is required | A preorder is required to proceed with this booking | No |
BOOK-N-008 | Card prepayment required | This booking requires a card pre‑payment, but card payments are not currently supported. | No |
BOOK-N-009 | TMS Booking Request Failed | The booking request was rejected by the table management system | No |
BOOK-N-010 | Space Does Not Exist | The specified space ID does not exist | No |
BOOK-N-011 | Space Not Configured | The space exists but is not linked to a TMS zone. Please configure the space correctly. | No |
BOOK-N-012 | Space Zone Has No Areas | The TMS zone linked to this space has no areas defined. Please sync areas to zone before booking. | No |
Venue retrieval and management errors
| Code | Title | Description | Retryable |
|---|---|---|---|
VENUE-N-001 | Venue Not Found | The requested venue could not be found | No |
VENUE-N-002 | Product Not Found for Venue | The specified product does not exist for this venue and cannot be used | No |
VENUE-N-003 | TMS Zone Not Found | The specified TMS zone does not exist for this venue | No |
VENUE-N-004 | Space Not Found | The requested Venue Bible space could not be found | No |
VENUE-N-005 | TMS Zone Cannot Be Cleared | This space already has a TMS zone; an update cannot remove it. Include the existing tms_zone_id in the request. | No |
Operator management and access errors
| Code | Title | Description | Retryable |
|---|---|---|---|
OPRTR-N-001 | Operator Not Found | The requested operator could not be found | No |
OPRTR-N-002 | Operator Access Denied | You do not have permission to access this operator | No |
OPRTR-N-003 | Partner Source Required | The partnerSource field is required when creating an operator as a partner user | No |
OPRTR-N-004 | Operator Already Exists | An operator with this name already exists | No |
OPRTR-N-005 | Cannot Delete Operator | This operator cannot be deleted because it has associated resources | No |
OPRTR-N-006 | Invalid Operator Configuration | The operator configuration is invalid or incomplete | No |
OPRTR-N-007 | TMS Credentials Already Exists | TMS credentials already exist for this operator and TMS combination | No |
OPRTR-N-008 | TMS Credentials Not Found | The requested TMS credentials for this operator could not be found | No |
OPRTR-N-009 | Invalid TMS Credentials | The TMS credentials could not be validated. Please check your configuration and try again. | No |
User management and authentication errors
| Code | Title | Description | Retryable |
|---|---|---|---|
USER-N-001 | Email Already In Use | A user with this email address already exists | No |
USER-N-002 | User Not Found | The specified user could not be found | No |
USER-N-003 | Invalid User Credentials | The provided credentials are invalid | No |
USER-N-004 | User Invite Not Found | The user invitation could not be found | No |
USER-N-005 | User Invite Already Accepted | This invitation has already been accepted | No |
USER-N-006 | User Invite Expired | This invitation has expired | No |
USER-N-007 | Invalid Venue Group Assignment | The user cannot be assigned to the specified venue group | No |
USER-N-008 | Insufficient Permissions | You do not have sufficient permissions to perform this action | No |
USER-N-009 | Invalid Role Assignment | The specified role cannot be assigned to this user | No |
USER-N-010 | User Account Disabled | This user account has been disabled | No |
USER-N-011 | Invalid Email Format | The provided email address format is invalid | No |
USER-N-012 | Password Requirements Not Met | The password does not meet security requirements | No |
USER-N-013 | User Session Expired | Your session has expired, please log in again | No |
USER-N-014 | Maximum Login Attempts Exceeded | Account locked due to too many failed login attempts | Yes |
USER-N-015 | Email Verification Required | Email address must be verified before proceeding | No |
Identity resolution errors
| Code | Title | Description | Retryable |
|---|---|---|---|
IDENT-N-001 | Invalid Identity | The identity could not be resolved | No |
IDENT-N-002 | Invalid Partner Reference | The partner reference could not be resolved | No |
Sandbox environment restriction errors
| Code | Title | Description | Retryable |
|---|---|---|---|
SBOX-N-001 | Not Available in Sandbox | This endpoint is not available in the sandbox environment | No |
Request validation errors
| Code | Title | Description | Retryable |
|---|---|---|---|
VALID-N-001 | Validation Failed | One or more validation errors occurred. | No |
Additional Response Fields for VALID-N-001:
errors(object): Dictionary of field names mapped to arrays of validation error messages"errors": { "Date": [ "Availability date cannot be in the past." ], "EndTime": [ "EndTime must be after StartTime." ]
}
## FSEL Errors (FSEL)
Field selection (partial response) validation errors
| Code | Title | Description | Retryable |
|------|-------|-------------|-----------|
| `FSEL-N-001` | Unknown Field | One or more requested field names are not valid for this resource type | No |
**Additional Response Fields for FSEL-N-001:**
- **`invalid_fields`** (array): List of unrecognised field names
```json
"invalid_fields": [
"badField",
"unknownNested"
]valid_fields(array): List of valid field names for the resource type
| FSEL-N-002 | Malformed Field Selection Syntax | The fields parameter contains malformed syntax (e.g. unmatched parentheses or empty field name) | No |
MCP tool invocation and parameter resolution errors
| Code | Title | Description | Retryable |
|---|---|---|---|
MCP-N-001 | Venue Group ID Required | venueGroupId must be provided when calling as an Administrator. | No |
API rate limiting errors
| Code | Title | Description | Retryable |
|---|---|---|---|
RATE-R-001 | Rate Limit Exceeded | Too many requests have been made in a short period. Please wait and retry. | Yes |
If you're migrating from the old error code format, here's the mapping:
| Old Code | New Code | Notes |
|---|---|---|
| USER001 | USER-N-001 | Email already in use |
| BOOKING001 | BOOK-N-001 | No RMS configurations |
| BOOKING002 | BOOK-N-002 | Booking already exists |
| BOOKING003 | BOOK-N-003 | RMS configuration not found |
| BOOKING004 | BOOK-N-004 | Missing partner source |
| BOOKING005 | BOOK-N-005 | Venue group partner association not found |
| OPERATOR_AVAILABILITY_DISABLED | OPRUL-N-001 to OPRUL-N-004 | Now split into 4 specific codes based on rule type |
| VENUE001 | VENUE-N-001 | Invalid pagination cursor |
| IDENTITY001 | IDENT-N-001 | Invalid identity |
| IDENTITY002 | IDENT-N-002 | Invalid partner reference |
Errors with isRetryable: true indicate transient failures that may succeed if retried:
- Implement exponential backoff
- Limit retry attempts (recommended: 3-5 attempts)
- Examples: Rate limits (429), temporary service unavailability
Errors with isRetryable: false indicate permanent failures:
- Do not retry with the same input
- Modify request parameters or contact support
- Examples: Invalid data (400), unauthorized (401), not found (404)
For questions or issues with error codes, please contact api-support@bookingsgroup.com.
Last updated: 2026-06-19 13:10:45 UTC Version: 2.0 This file is auto-generated from ErrorCatalog.yaml - DO NOT EDIT MANUALLY