Errors

All errors follow a consistent structure.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The date field is required.",
    "details": {
      "date": ["The date field is required."]
    }
  },
  "meta": {
    "timestamp": "2026-03-18T10:00:00Z"
  }
}

The details field is always present. When there are no additional details it is null (for example, on a 404 lookup failure):

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Booking not found.",
    "details": null
  },
  "meta": {
    "timestamp": "2026-03-18T10:00:00Z"
  }
}

Common Error Codes

• UNAUTHORIZED - Missing or invalid token
• FORBIDDEN - Missing ability or IP not allowed
• API_DISABLED - API access is disabled for the restaurant
• NOT_FOUND - Requested resource (booking or patron) does not exist for this restaurant
• BOOKING_INVALID - Booking validation failed
• VALIDATION_ERROR - Request validation failed