Skip to main content
POST
Read a dated partial hotel offer
Fresh Booking.com hotel-level price observation for this account’s retained Paris stay, explicit future1–30 nights,two adults,no children/infants/pets,one room,USD,no locale. Fully dated URL binds guest context. Reported base plus combined taxes/fees must reconcile. Completeness stays partial: unique bookable room/rate, all mandatory charges and cancellation are unestablished. No booking/payment/price guarantee. Costs50 credits;errors/replay0. Booking stay discovery requires explicit limit 1 and the documented Paris source region. It uses the provider-supported Paris destination ID; free-text autocomplete is not used. No unique hotel returns 404 at zero credits. Unknown room capacity is not inferred from hotel-level guest context; the quoted offer remains partial and does not identify a uniquely bookable room/rate.
Use this account’s unexpired 24-hour stay observation. Errors and prior-response replay cost zero. The existing seven-day replay cache returns a previous snapshot and can outlive selector retention.

Authorizations

x-api-key
string
header
required

Path Parameters

stay_id
string
required
Minimum string length: 1

Body

application/json

check_out must be after check_in; source-specific stay length and guest limits are validated at runtime.

check_in
string<date>
required
check_out
string<date>
required
guests
object
required
currency
string
required
Pattern: ^[A-Z]{3}$
locale
string

Response

Successful response; meta discloses source completeness

data
object
required
meta
object
required