Rates & Availability Push
Use ari to send rates and business days per rate plan. Use ari/avails to send availability per room type. For the full sequence, see the Initial Setup overview.
| Method | Path | Description |
|---|---|---|
POST | .../ari | Rates and business days (per rate plan, vendor_rateplan_id) |
POST | .../ari/avails | Availability, vacancy (consolidated per room type; at most 730 days per item) |
Send the shared values and the channel settings (channels[]) in the same request to either endpoint. Include every channel setting you want to keep for the item's date range. ONDA deletes settings in that range for channels you leave out of the array.
Rates and business days — overnight (overnight)
[
{
"vendor_roomtype_id": "VRT-001",
"vendor_rateplan_id": "VRP-001",
"type": "overnight",
"from": "2026-01-01",
"to": "2026-01-31",
"basic_price": 0,
"net_price": 0,
"sale_price": 12000,
"is_business_day": 0,
"channels": [
{ "channel_id": 1, "basic_price": 0, "net_price": 0, "sale_price": 10000, "is_business_day": 0 },
{ "channel_id": 2, "basic_price": 0, "net_price": 0, "sale_price": 11000, "is_business_day": 0 }
]
}
]
Rates and business days — day-use (dayuse)
[
{
"vendor_roomtype_id": "VRT-001",
"vendor_rateplan_id": "VRP-001",
"type": "dayuse",
"from": "2026-01-01",
"to": "2026-01-31",
"basic_price": 0,
"net_price": 0,
"sale_price": 12000,
"is_business_day": 0,
"use_from": "14:00",
"use_to": "20:00",
"use_time": 240,
"channels": [
{ "channel_id": 1, "basic_price": 0, "net_price": 0, "sale_price": 10000, "is_business_day": 0, "use_from": "14:00", "use_to": "20:00", "use_time": 240 }
]
}
]
Availability — consolidated per room type
[
{
"vendor_roomtype_id": "VRT-001",
"type": "overnight",
"from": "2026-01-01",
"to": "2026-01-31",
"vacancy": 5,
"channels": [
{ "channel_id": 1, "vacancy": 3 },
{ "channel_id": 2, "vacancy": 5 }
]
}
]
:::info Push rules
POST .../ariupdates rates and business days per rate plan. Each item requiresis_business_dayand eithernet_priceorsale_price. Includeis_business_dayand the same set of rate fields in every entry inchannels[]. The API returns400if the set of rate fields differs. If you omitchannelsor send an empty array, ONDA deletes all channel settings for that date range. Rate fields you omit from the item keep their existing values. Senduse_from,use_to, anduse_time(in minutes) only for day use.POST .../ari/availsupdates availability per room type. Include inchannels[]every channel whose availability you want to keep for the date range. ONDA deletes availability for omitted channels within that range. Each item can cover up to 730 days. :::
:::info Currency of overnight rates
ONDA uses the property's currency for overnight (overnight) rates, including rates in channels[]. If the property has no currency, ONDA uses KRW.
Set currency when you create a property or update a property. For example, if the property's currency is USD, sale_price: 100 in a rate push means 100 US dollars. ONDA does not convert the amounts you send.
:::
:::info The type field (overnight or day-use)
Both ari and bookings (/bookings) use type to distinguish product types.
| Channel type | type used |
|---|---|
| Plus channel | overnight |
| Direct channel | overnight (channels that support day-use also send dayuse) |
| ::: |
:::tip ARI supports partial pushes
- Partial push: include only the items you want to change
- Fields per item: business day =
is_business_day; rates =basic_price,sale_price,net_price; availability =vacancy(viaari/avails) - Day-use only:
use_from,use_to, anduse_timemay be sent only for day-use - One call per push: shared values at the top level, per-channel values in the
channels[]array :::
:::warning Availability policy — align to room-only (room type) counts Channels count availability by room type or by rate plan.
- Room-only (room type): Booking.com, Agoda, Trip.com
- Rate plan: Expedia, Plus channels (with some optional cases)
ONDA counts availability by room type. Send that count for both package and standalone.
:::