---
title: "ARIUpdate"
method: POST
path: "/ARIUpdate"
tags: ["ARI"]
---

# ARIUpdate

`POST /ARIUpdate`

This call is used to send availability, rates and restrictions to your OTA.
We will combine the updates into as few date ranges as possible, and we
split bigger updates into several API requests. We also cache data and will
not send ARI updates if the ARI data has not changed within a certain
timeframe. You can ask us to alter the number of `Inventory` objects we send
per request. It's also possible to ask us to restrict maximum number of days
per date range.

Note that Cloudbeds only supports availability on the room level, so for
the same `ota_room_id` and the same date range the availability will always
be the same. Only restrictions and rates are sent on the rate plan level.

## Request body

- object
  - `mya_property_id` integer, required — Property ID on the Cloudbeds channel manager
  - `ota_property_id` string, required — Username, login or property ID on the OTA
  - `ota_property_password` string, required — Password for property on your OTA. In case the OTA does not use passwords this will be an empty string.
  - `ota_property_sub_id` string, required — Property ID on the OTA, if OTA supports multiple properties under one `ota_property_id`/`ota_property_password` combination. See `GetSubProperties` for more details.
  - `guid` string, required — Request reference ID, used for debugging and support requests.
  - `shared_secret` string, required — Authentication between the OTA and the channel. Identical for all requests. Not to be shared with customers.
  - `ota_cid` string, required — OTA ID as given by Cloudbeds
  - `verb` 'ARIUpdate', required
  - `currency` string, required — 3-letter ISO 4217 currency code. This is the currency the property has set for the channel connection, and may differ from the property's native currency. The OTA can use this field to assert that rates are sent in the correct currency.
  - `Inventory` object[], required
    - `ota_room_id` string, required — Room ID on the OTA.
    - `ota_rate_id` string, required — Rate plan ID on the OTA
    - `start_date` string, date, required — Start date for when the sent ARI is applicable.
    - `end_date` string, date, required — End date for when the sent ARI is applicable. Note that this date is inclusive. For example, if the `end_date` is 2028-08-29 and we send `rate` = `20.15`, then this rate is applicable for someone staying/arriving on 2028-08-29.
    - `units` integer — Number of rooms bookable (available) for private rooms, or for the number of beds for shared/dorm rooms.
    - `rate` string — Price per unit for a single night.
    - `rdef_single` string — The single use rate, if only one person is staying. This will only be present for private rooms, and only if the occupancy of this room is higher than `1`. If the value is `0` we recommend to not make the single use rate available, or to just use the same price as for `rate`.
    - `num_adults_included` integer — Number of adults included in base rate. Sent for OBP enabled channels.
    - `num_children_included` integer — Number of children included in base rate. Sent for OBP enabled channels.
    - `max_los` integer — Maximum length of stay. A guest should not be able to book if they selected more nights than this value. A value of `0` means that there is no restriction. There are two ways to restrict bookings by this value: a) Check the `max_los` value for the arrival date, or b) check the `max_los` value for all days the guest is intending to stay and restrict by the lowest value.
    - `min_los` integer — Minimum length of stay. A guest should not be able to book if they selected fewer nights than this value. There are two ways to restrict bookings by this value: a) Check the `min_los` value for the arrival date, or b) check the `min_los` value for all days the guest is intending to stay and restrict by the lowest value.
    - `closearr` boolean — Restricts whether a guest can arrive within the specified date range. If `true` the guest can stay and depart within the date range, but not arrive.
    - `closedep` boolean — Restricts whether a guest can depart within the specified date range. If `true` the guest can stay and arrive within the date range, but not depart.
    - `close` boolean — Restricts whether a guest can stay within the specified date range. If `true` the guest cannot arrive, stay or depart within the date range. In many cases this is equivalent to `units` = 0, however it is also used to make specific rate plans unavailable while leaving others bookable.
    - `min_advanced_offset` integer — Cut off restriction: Specifies the number of days before the arrival date guests are allowed to book. The value of 0 resets to no restriction, which is the default. This restriction is mainly used for properties that want to have a lot of advanced bookings by offering a heavily discounted rate if guests book at least X number of days in advance.
    - `max_advanced_offset` integer — Last Minute restriction: The number of days before the arrival date guests can book. The value of 0 resets to no restriction, which is the default. This restriction is mainly used to boost last-minute reservations.
    - `adult_3` string — Extra price for the 3rd adult. Additional adults follow the same pattern (adult_4, adult_5, etc.). Sent for OBP enabled channels.
    - `adult_4` string — Extra price for the 4th adult.
    - `child_3` string — Extra price for the 3rd child. Additional children follow the same pattern (child_4, child_5, etc.). Sent for OBP enabled channels.
    - `child_4` string — Extra price for the 4th child.

## Response `200`

ARIUpdate

- ResponseSimple
  - `errors` object[] — Array of error objects. Required when `success` is `false`.
    - `id` integer, required — Error code. Check the "Error Codes" section of the specification for valid codes.
    - `msg` string — Optional error string to give more details about the error. Myallocator localises errors into different languages, so this field is generally ignored and only useful for debugging.
  - `success` true | false, required

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)