Response Codes

Common Response Codes

• 200 OK - Request successful
• 400 Bad Request - Invalid request parameters
• 401 Unauthorized - Invalid or missing authentication
• 402 Payment Required - Trial tier account (Full tier required)
• 404 Not Found - Hotel not found or no Google Hotel ID
• 429 Too Many Requests - Rate limit exceeded
• 500 Server Error - Internal server error

Error Responses

400 Bad Request

Missing or invalid parameters.

{
  "name": "ClientError",
  "message": "hotelId must be provided",
  "status": 400
}

401 Unauthorized

Invalid or missing authentication token.

{
  "name": "AuthError",
  "message": "Authentication required",
  "status": 401
}

402 Payment Required

Your account is on Trial tier. Metasearch requires Full tier access.

{
  "name": "ClientError",
  "message": "Upgrade to access metasearch. Contact sales at: hello@ubio.ai",
  "status": 402
}

404 Not Found

Hotel not found, or Metasearch not available for this hotel.

{
  "name": "ClientError",
  "message": "Hotel not found",
  "status": 404
}

or

{
  "name": "ClientError",
  "message": "Metasearch not available for this hotel",
  "status": 404
}

429 Rate Limit Exceeded

Too many requests. Check the Retry-After header for seconds to wait.

{
  "name": "RateLimitError",
  "message": "Rate limit exceeded",
  "status": 429
}

Response Headers:

• Retry-After: Number of seconds to wait before retrying

500 Internal Server Error

Server or upstream service error.

{
  "name": "ServerError",
  "message": "Internal server error",
  "status": 500
}