{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/flights/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["abbr"]},"type":"markdown"},"seo":{"title":"Search Workflows","description":"Create AI-native travel products with Travelport's powerful, flexible APIs.","siteUrl":"https://developer.travelport.com/","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":"search-workflows","__idx":0},"children":["Search Workflows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can combine the into various workflows, determined by whether you want more upsells, and whether you want the initial Search to return offers for all legs of the itinerary ( a journey-based search) or only the first leg (a leg-based search). A leg-based search must be followed by a Next Leg Search to return offers on the subsequent leg of the itinerary. For a leg-based, multi-city itinerary you would send Next Leg Search again for the third leg, and so on for additional legs (not shown below)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To set whether the search is journey- or leg-based, send SearchRepresentation with the value ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Leg"]}," for a leg-based search or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Journey"]}," for a journey-based search. If SearchRepresentation is not sent, the default is a journey-based response. This setting does not apply to one-way searches and is ignored if sent for one-way."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request upsells in the initial Search response, send maxNumberOfUpsellsToReturn to return up to 4 upsells. For more, you can add the Flight Specific Search API to the workflow. Flight Specific Search is an optional request to return up to 99 upsells (up to as many as the carrier has filed), for any ",{"$$mdtype":"Tag","name":"abbr","attributes":{"title":"The flight or connecting flights between one origin and destination pair. For example, on a round-trip flight, LAX>MSP ould be the first leg (aka outbound leg) and MSP>DEN>LAX could be thesecond leg(aka inbound leg). The APIs use the term poduct for one leg of the itinerary"},"children":[" leg"]}," or ",{"$$mdtype":"Tag","name":"abbr","attributes":{"title":"In the Search APIs, an offer is a product available at a specific price under a set of terms and conditions. An offer includes the flight or connecting flights for one leg of the itinerary, plus a service level that includes the cabin class and any fare codes that may apply. At booking, the selected offer from the Search response - including the flight/s, service level, price, terms and conditions,and brand if applicable - is converted into a single Offer object that is subsequentlyreturned for that booking."},"children":["offer "]}," returned in a preceding Search or Next Leg Search."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that you can send Flight Specific Search any time in the workflow after the initial search, and you can send it multiple times. For example, in the last diagram below, you could send Flight Specific Search after Search, either in addition to or instead of sending it after Next Leg Search. Sending Flight Specific Search after the first search allows you consider upsells before requesting options in your Next Leg Search."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each box in the diagram represents one API call in the workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-workflow-options","__idx":1},"children":["Search Workflow options"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"search-only-for-one-way-journey-based-round-trip-or-multi-city-itinerary-with-no-additional-upsells","__idx":2},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search only:"]}," For one-way, journey-based round trip, or multi-city itinerary, with no additional upsells."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\nA[\"Search\\n(journey-based)\"]\n","diagramHtml":"

Search
(journey-based)

","diagramHtmlDark":"

Search
(journey-based)

"},"children":["flowchart TD\nA[\"Search\\n(journey-based)\"]\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"search--upsells-for-one-way-journey-based-round-trip-or-multi-city-itinerary-with-additional-upsells","__idx":3},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search + upsells:"]}," For one-way, journey-based round trip, or multi-city itinerary, with additional upsells."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\nA[\"Search\\n(journey-based)\"]\nB[\"Flight Specific Search\\n(for product/s on any leg)\"]\n\n A --> B \n","diagramHtml":"

Search
(journey-based)

Flight Specific Search
(for product/s on any leg)

","diagramHtmlDark":"

Search
(journey-based)

Flight Specific Search
(for product/s on any leg)

"},"children":["flowchart TD\nA[\"Search\\n(journey-based)\"]\nB[\"Flight Specific Search\\n(for product/s on any leg)\"]\n\n A --> B \n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"leg-based-search--next-leg-search-for-round-trip-itinerary-returned-one-leg-at-a-time-with-no-additional-upsells","__idx":4},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leg-based Search + Next Leg Search:"]}," For round-trip itinerary returned one leg at a time, with no additional upsells."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\nA[\"Search\\n(leg-based)\"]\nB[\"Next Leg Search\\n(required after leg-based search)\"]\n\n A --> B \n","diagramHtml":"

Search
(leg-based)

Next Leg Search
(required after leg-based search)

","diagramHtmlDark":"

Search
(leg-based)

Next Leg Search
(required after leg-based search)

"},"children":["flowchart TD\nA[\"Search\\n(leg-based)\"]\nB[\"Next Leg Search\\n(required after leg-based search)\"]\n\n A --> B \n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"leg-based-search--next-leg-search-for-round-trip-itinerary-returned-one-leg-at-a-time-with-additional-upsells-on-any-leg","__idx":5},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leg-based Search + Next Leg Search:"]}," For round-trip itinerary returned one leg at a time, with additional upsells on any leg."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\nA[\"Search\\n(leg-based)\"]\nB[\"Next Leg Search\\n(required after leg-based search)\"]\nC[\"Flight Specific Search\\n(for product/s on any leg)\"]\n\n A --> B --> C\n","diagramHtml":"

Search
(leg-based)

Next Leg Search
(required after leg-based search)

Flight Specific Search
(for product/s on any leg)

","diagramHtmlDark":"

Search
(leg-based)

Next Leg Search
(required after leg-based search)

Flight Specific Search
(for product/s on any leg)

"},"children":["flowchart TD\nA[\"Search\\n(leg-based)\"]\nB[\"Next Leg Search\\n(required after leg-based search)\"]\nC[\"Flight Specific Search\\n(for product/s on any leg)\"]\n\n A --> B --> C\n"]}]},"headings":[{"value":"Search Workflows","id":"search-workflows","depth":1},{"value":"Search Workflow options","id":"search-workflow-options","depth":3},{"value":"Search only: For one-way, journey-based round trip, or multi-city itinerary, with no additional upsells.","id":"search-only-for-one-way-journey-based-round-trip-or-multi-city-itinerary-with-no-additional-upsells","depth":4},{"value":"Search + upsells: For one-way, journey-based round trip, or multi-city itinerary, with additional upsells.","id":"search--upsells-for-one-way-journey-based-round-trip-or-multi-city-itinerary-with-additional-upsells","depth":4},{"value":"Leg-based Search + Next Leg Search: For round-trip itinerary returned one leg at a time, with no additional upsells.","id":"leg-based-search--next-leg-search-for-round-trip-itinerary-returned-one-leg-at-a-time-with-no-additional-upsells","depth":4},{"value":"Leg-based Search + Next Leg Search: For round-trip itinerary returned one leg at a time, with additional upsells on any leg.","id":"leg-based-search--next-leg-search-for-round-trip-itinerary-returned-one-leg-at-a-time-with-additional-upsells-on-any-leg","depth":4}],"frontmatter":{"seo":{"title":"Search Workflows"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/flights/workflows/flights-search/search-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}