Trial booking

Overview

Validate that the selected hotel product is still bookable and obtain the latest booking-time price. This is the required pre-booking step.

When to use

  • The traveler starts the booking flow.
  • Immediately before submitting an order with the actual room quantity.

What you get

  • Bookability result and the current booking-time price details.
  • Breakfast and tax data when returned.

Integration notes

Pass the actual room count. If there is a delay between the initial check and order submission, run the check again before Create order. A successful result is not a final booking confirmation.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Pass the business request body directly. Do not wrap it in header / businessRequest.

number
required

Hotel ID

number
required

Room ID

string
required

Rate plan ID

string
required

Check-in date in yyyy-MM-dd format.

string
required

Check-out date in yyyy-MM-dd format.

integer
required

Number of rooms

string
required

Supplier code

integer
required

Adults per room

integer

Children per room

string

Children ages. Required when numberOfChildren is not empty, and the number of ages must match numberOfChildren. Separate multiple ages with commas. Example: numberOfChildren=2 and childrenAges="1,2" means two children aged 1 and 2. Use 0 for children younger than 1 year old.

string

Country/region alpha-2 code. See ISO Country/Region Code in the dictionary.

string

Language. zh-CN for Chinese and en-US for English. Defaults to English.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json