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
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
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