{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/stays/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Stays API Workflow","description":"Create AI-native travel products with Travelport's powerful, flexible APIs.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"stays-api-workflow","__idx":0},"children":["Stays API Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/guides/stays-general-guide"},"children":["TripServices Stays APIs Guide"]}," for more about API versioning and the data model the TripServices APIs are based on."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"hotel-booking-workflow-with-all-v11-apis","__idx":1},"children":["Hotel booking workflow with all v11 APIs"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\n A[\"Hotel search\"]\n B[\"Hotel details\\n(optional)\"]\n C[\"Hotel\\navailability\"]\n D[\"Hotel rules\\n(optional)\"]\n E[\"Create\\nreservation\"]\n\n A --> B --> C --> D --> E\n\n","diagramHtml":"","diagramHtmlDark":""},"children":["flowchart TD\n A[\"Hotel search\"]\n B[\"Hotel details\\n(optional)\"]\n C[\"Hotel\\navailability\"]\n D[\"Hotel rules\\n(optional)\"]\n E[\"Create\\nreservation\"]\n\n A --> B --> C --> D --> E\n\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"hotel-booking-workflow-with-v12-searchcomplete-api-with-v11-rules-and-booking","__idx":2},"children":["Hotel booking workflow with v12 SearchComplete API with v11 rules and booking"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\n A[\"SearchComplete\\nv12\"]\n B[\"Hotel rules v11\\n(optional)\"]\n C[\"Create\\nreservation\\nv11\"]\n\n A --> B --> C\n\n","diagramHtml":"","diagramHtmlDark":""},"children":["flowchart TD\n A[\"SearchComplete\\nv12\"]\n B[\"Hotel rules v11\\n(optional)\"]\n C[\"Create\\nreservation\\nv11\"]\n\n A --> B --> C\n\n"]}]},"headings":[{"value":"Stays API Workflow","id":"stays-api-workflow","depth":1},{"value":"Hotel booking workflow with all v11 APIs","id":"hotel-booking-workflow-with-all-v11-apis","depth":4},{"value":"Hotel booking workflow with v12 SearchComplete API with v11 rules and booking","id":"hotel-booking-workflow-with-v12-searchcomplete-api-with-v11-rules-and-booking","depth":4}],"frontmatter":{"seo":{"title":"Stays API Workflow"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/stays/workflows","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}