For the complete documentation index, see llms.txt. This page is also available as Markdown.

API Hotel Availability

Endpoint: availability

Lowest price across 1–50 hotels. Limits: max 30 nights, 1–8 rooms, 1–8 adults per room, children aged 0–17.

Request

Field
Type
Required
Description

masterIds[]

string[]

✔

1–50 ids

checkin

date

✔

yyyy-MM-dd

checkout

date

✔

At most 30 nights after checkin

rooms[]

array

✔

1–8 rooms, each { adults, childAges[] }

language

enum

vi | en

{
  "masterIds": ["30715", "1002", "9999"],
  "checkin": "2026-11-20",
  "checkout": "2026-11-22",
  "rooms": [{ "adults": 2, "childAges": [6] }],
  "language": "en"
}

Response

Field
Type
Description

checkin, checkout, nights

Echoed from the request

complete

boolean

false = some price sources have not answered yet

results[].masterId

string

results[].status

enum

AVAILABLE | SOLD_OUT | NOT_FOUND

results[].lowestPrice

Money

total, perNight, currency, taxIncluded, taxAndFees, totalBeforePromo

results[].refundable

boolean

results[].freeCancellation

boolean

The lowest rate is free-cancellation; the detailed penalty schedule comes from offers

results[].breakfastIncluded

boolean

results[].promo

boolean

Promotion applied → totalBeforePromo is the strikethrough price

results is sorted by masterId as a string (e.g. "10" precedes "9"), not in request order — join results by masterId.

Cập nhật lần cuối