Errors

{
  "statuscode": 409,
  "message": "room type 412 has 0 left on 2026-12-21; 1 requested",
  "data": {
    "code": "NO_AVAILABILITY",
    "details": {
      "roomTypeId": 412,
      "date": "2026-12-21",
      "available": 0,
      "requested": 1
    }
  }
}

{
  "statuscode": 401,
  "message": "Unauthorized",
  "data": {
    "code": "API_KEY_INVALID"
  }
}

{
  "statuscode": 401,
  "message": "Unauthorized",
  "data": {
    "code": "API_KEY_REVOKED"
  }
}

{
  "statuscode": 403,
  "message": "This API key may not be used from this address. The property owner restricts it to an allowlist.",
  "data": {
    "code": "IP_NOT_ALLOWED"
  }
}

{
  "statuscode": 403,
  "message": "This API key does not have the bookings:write scope. The property owner grants scopes when creating or editing a key.",
  "data": {
    "code": "SCOPE_MISSING",
    "details": {
      "needed": "bookings:write",
      "held": [
        "ari:read",
        "ari:write"
      ]
    }
  }
}

{
  "statuscode": 409,
  "message": "This property is not available to the API any more. Contact the property owner.",
  "data": {
    "code": "PROPERTY_UNAVAILABLE"
  }
}

{
  "statuscode": 409,
  "message": "This property's channel manager is switched off, so writes would not reach any channel. Contact the property owner.",
  "data": {
    "code": "CHANNEL_MANAGER_DISABLED"
  }
}

{
  "statuscode": 409,
  "message": "This property runs the channel manager only; there is no PMS to put a booking in.",
  "data": {
    "code": "PMS_NOT_AVAILABLE"
  }
}

{
  "statuscode": 400,
  "message": "updates[0].available: Expected number, received string",
  "data": {
    "code": "VALIDATION",
    "details": [
      {
        "path": [
          "updates",
          0,
          "available"
        ],
        "message": "Expected number, received string"
      }
    ]
  }
}

{
  "statuscode": 400,
  "message": "updates[0]: 2028-01-01 is beyond the horizon (last writable night is 2027-10-12, today + 365 days)",
  "data": {
    "code": "HORIZON"
  }
}

{
  "statuscode": 400,
  "message": "a request may name at most 5000 cells (entity × night); split the calendar into several requests",
  "data": {
    "code": "TOO_MANY_CELLS"
  }
}

{
  "statuscode": 400,
  "message": "rate plan(s) 77 do not belong to this property (see GET /catalog)",
  "data": {
    "code": "UNKNOWN_RATE_PLAN",
    "details": {
      "ratePlanIds": [
        77
      ]
    }
  }
}

{
  "statuscode": 400,
  "message": "rates must be sent in INR (got EUR)",
  "data": {
    "code": "CURRENCY_MISMATCH",
    "details": {
      "expected": "INR",
      "got": "EUR"
    }
  }
}

{
  "statuscode": 429,
  "message": "Too many requests on this API key. Slow down and retry after the Retry-After interval.",
  "data": {
    "code": "RATE_LIMITED"
  }
}

{
  "statuscode": 422,
  "message": "exceptions are switched off for this property — move the base rate instead",
  "data": {
    "code": "NOTHING_ACCEPTED",
    "details": {
      "rejected": [
        {
          "cells": 151,
          "error": "exceptions are switched off for this property — move the base rate instead"
        }
      ]
    }
  }
}

{
  "statuscode": 404,
  "message": "Batch not found.",
  "data": {
    "code": "BATCH_NOT_FOUND"
  }
}

{
  "statuscode": 400,
  "message": "checkIn 2026-10-01 is in the past (today at the property is 2026-10-20)",
  "data": {
    "code": "STAY_INVALID",
    "details": {
      "today": "2026-10-20"
    }
  }
}

{
  "statuscode": 400,
  "message": "rooms[0]: Deluxe takes at most 3 adults (got 4)",
  "data": {
    "code": "OCCUPANCY_EXCEEDED",
    "details": {
      "index": 0,
      "roomTypeId": 412,
      "maxAdults": 3
    }
  }
}

{
  "statuscode": 409,
  "message": "room type 412 has 0 left on 2026-12-21; 1 requested",
  "data": {
    "code": "NO_AVAILABILITY",
    "details": {
      "roomTypeId": 412,
      "date": "2026-12-21",
      "available": 0,
      "requested": 1
    }
  }
}

{
  "statuscode": 403,
  "message": "This API key may not record payments. The property owner grants the bookings:payments scope.",
  "data": {
    "code": "PAYMENT_NOT_ALLOWED",
    "details": {
      "needed": "bookings:payments"
    }
  }
}

{
  "statuscode": 400,
  "message": "payment.amount 30000.00 exceeds the stay total 27000.00",
  "data": {
    "code": "PAYMENT_EXCEEDS_TOTAL",
    "details": {
      "amount": "30000.00",
      "total": "27000.00"
    }
  }
}

{
  "statuscode": 404,
  "message": "Booking not found.",
  "data": {
    "code": "BOOKING_NOT_FOUND"
  }
}

{
  "statuscode": 409,
  "message": "Booking already checked in. Ask the hotel to handle it at the desk.",
  "data": {
    "code": "BOOKING_NOT_CANCELLABLE"
  }
}

{
  "statuscode": 402,
  "message": "This property's plan does not include the PMS.",
  "data": {
    "code": "MODULE_NOT_ENTITLED",
    "details": {
      "module": "PMS"
    }
  }
}

{
  "statuscode": 409,
  "message": "This idempotency key was already used with a different request body.",
  "data": {
    "code": "IDEMPOTENCY_KEY_REUSED"
  }
}