Errors & limits

HTTP status codes, error shapes, and rate limits.

Error response

{
  "error": {
    "code": "insufficient_inventory",
    "message": "Not enough availability for selected dates"
  }
}

Common codes

| HTTP | Code | Meaning | |------|------|---------| | 400 | `invalid_request` | Malformed or missing fields | | 401 | `unauthorized` | Missing or invalid API key | | 403 | `forbidden` | Key lacks permission for resource | | 404 | `not_found` | Resource does not exist | | 409 | `insufficient_inventory` | Booking would oversell | | 429 | `rate_limited` | Too many requests |

Rate limits

Sandbox: 100 requests/minute per key. Production: 1,000 requests/minute default (higher on enterprise plans). Respect `Retry-After` header on `429` responses.

← Sandbox