Skip to main content

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.

MethodPathDescription
POST.../ariRates and business days (per rate plan, vendor_rateplan_id)
POST.../ari/availsAvailability, 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 .../ari updates rates and business days per rate plan. Each item requires is_business_day and either net_price or sale_price. Include is_business_day and the same set of rate fields in every entry in channels[]. The API returns 400 if the set of rate fields differs. If you omit channels or send an empty array, ONDA deletes all channel settings for that date range. Rate fields you omit from the item keep their existing values. Send use_from, use_to, and use_time (in minutes) only for day use.
  • POST .../ari/avails updates availability per room type. Include in channels[] 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 typetype used
Plus channelovernight
Direct channelovernight (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 (via ari/avails)
  • Day-use only: use_from, use_to, and use_time may 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. :::