Skip to content
Last updated

Stays API Workflow

The following high-level diagram represents the required and optional steps in the hotel booking workflow. Each box in the diagram represents one API call in the workflow.

The first diagram shows the workflow when using v11 APIs for all steps. The minimum required workflow is a hotel search (either by location or property ID), followed by an Availability request, and booking the reservation. The Hotel Details and Rules requests in this diagram are optional.

See the TripServices Stays APIs Guide for more about API versioning and the data model the TripServices APIs are based on.

Hotel booking workflow with all v11 APIs

Hotel search

Hotel details
(optional)

Hotel
availability

Hotel rules
(optional)

Create
reservation

Hotel search

Hotel details
(optional)

Hotel
availability

Hotel rules
(optional)

Create
reservation

The next diagram shows the flow when starting with the SearchComplete v12 API. This API combines into a single API the information that in v11 is returned in separate search, details, and availability requests. Model version 12 is available for only search functionality. Use v11 APIs after SearchComplete. You can go straight to booking, or you can request Rules if desired.

Hotel booking workflow with v12 SearchComplete API with v11 rules and booking

SearchComplete
v12

Hotel rules v11
(optional)

Create
reservation
v11

SearchComplete
v12

Hotel rules v11
(optional)

Create
reservation
v11