{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","small-center"]},"type":"markdown"},"seo":{"title":"Air express search","meta":[{"name":"robots","content":"noindex"}],"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":"air-express-search","__idx":0},"children":["Air express search"]},{"$$mdtype":"Tag","name":"p","attributes":{"style":{"fontSize":"1.25rem","fontWeight":"500","opacity":"0.7","margin":"0.25rem 0 1.5rem 0"}},"children":["Prioritizing non-stop flights on high-volume routes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"feature-overview","__idx":1},"children":["Feature overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Air express search allows you to prioritize and display only non-stop flights on busy routes. This optimizes the air search and displays the results faster compared to a full search."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the express search is enabled:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only non-stop flights are displayed by default."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An option for travelers to also view flights with one or more stops is displayed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If there aren't enough non-stop flights for a specific route, then the extended search is triggered and will display all available flights."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-benefits","__idx":2},"children":["Key benefits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating air express search reduces API latency by intelligently prioritizing non-stop flights on high-volume routes."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart TD\n A1[API Request] --> A2([searchMode: EXPRESS])\n A2 --> B{Non-stop flights >= threshold?}\n B -->|Yes| C[Return non-stop flights only]\n B -->|No| D([EXPRESS_EXTENDED])\n D --> E[Return all flights]\n C --> F{User satisfied?}\n F -->|Yes| G[End]\n F -->|No| H[User clicks 'Show all flights']\n H --> I([searchMode: EXPRESS_EXTENDED])\n I --> E\n","diagramHtml":"

Yes

No

Yes

No

API Request

searchMode: EXPRESS

Non-stop flights >= threshold?

Return non-stop flights only

EXPRESS_EXTENDED

Return all flights

User satisfied?

End

User clicks 'Show all flights'

searchMode: EXPRESS_EXTENDED

"},"children":["flowchart TD\n A1[API Request] --> A2([searchMode: EXPRESS])\n A2 --> B{Non-stop flights >= threshold?}\n B -->|Yes| C[Return non-stop flights only]\n B -->|No| D([EXPRESS_EXTENDED])\n D --> E[Return all flights]\n C --> F{User satisfied?}\n F -->|Yes| G[End]\n F -->|No| H[User clicks 'Show all flights']\n H --> I([searchMode: EXPRESS_EXTENDED])\n I --> E\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-procedure","__idx":3},"children":["Integration procedure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following sections explain how to use air express search:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-prerequisites","__idx":4},"children":["1. Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The settings below must be configured in the backend before starting API integration."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Feature flag"]},": Contact your Spotnana representative to enable the express search feature for your company profile."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Threshold configuration"]},": The threshold setting indicates whether a specific route qualifies for an express search based on non-stop flight availability. The default value configured by Spotnana will be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[">=15"]}," non-stop flights (i.e., the API will only use express search if a specific route contains 15 or more non-stop flight schedules). Contact your Spotnana representative if you wish to adjust the threshold to another value before integrating."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-api-implementation","__idx":5},"children":["2. API implementation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode: EXPRESS"]}," in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/airapi/air/airsearch"},"children":["get air itineraries"]}," API request to initiate the air express search. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode"]}," supports the following values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"Search mode"},"children":["Search mode "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NORMAL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard search that returns all available flight itineraries. This is used as a default value when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode"]}," is not set in the API request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filters the results to display only non-stop flights on the specific route (assuming the threshold has been met)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS_EXTENDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A fallback search mechanism when express search doesn't find enough non-stop flights (i.e., less than the threshold value). This mode is also used when the user is not satisfied with the express search results and wants to view all flight options instead."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's a sample request for the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/airapi/air/airsearch"},"children":["get air itineraries"]}," API where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS"]}," on busy routes."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"POST /v2/air/search-flights","data-highlight":"{16}","header":{"title":"POST /v2/air/search-flights","controls":{"copy":{}}},"source":"// ... payload truncated for focus\n{\n \"legs\": [\n {\n \"origin\": {\n \"airport\": \"JFK\"\n },\n \"destination\": {\n \"airport\": \"LAX\"\n },\n \"date\": {\n \"iso8601\": \"2026-12-15\"\n }\n }\n ],\n \"searchMode\": \"EXPRESS\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-threshold-and-fallback-mechanism","__idx":6},"children":["3. Threshold and fallback mechanism"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/airapi/air/airsearch"},"children":["get air itineraries"]}," API call employs a fallback mechanism based on the threshold value configured in the backend (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#prerequisites"},"children":["prerequisites"]}," for more information). Consider the following scenarios:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scenario A:"]}," The number of non-stop flights is greater than or equal to the threshold value"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API behavior:"]}," The API uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode: EXPRESS"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result:"]}," Only non-stop flights are returned and the response time is reduced."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scenario B:"]}," The number of non-stop flights is less than the threshold value"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API behavior:"]}," The API call uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode: EXPRESS_EXTENDED"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result:"]}," All the available flights (both non-stop and those with connections) are returned."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-pagination","__idx":7},"children":["4. Pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To control the volume of flight itineraries displayed and to optimize the frontend rendering, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legSearchParams"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageSize"]}," field in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/airapi/air/airsearch"},"children":["get air itineraries"]}," API to paginate the results displayed. Pagination works for all search modes (i.e., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NORMAL"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS_EXTENDED"]},"). The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageSize"]}," field assumes a default value of 50 if no value is provided in the request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"POST /v2/air/search-flights","data-highlight":"{5}","header":{"title":"POST /v2/air/search-flights","controls":{"copy":{}}},"source":"{\n // ... payload truncated for focus\n \"searchMode\": \"EXPRESS\",\n \"legSearchParams\": {\n \"pageSize\": 25\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-frontend-ui-recommendations","__idx":8},"children":["5. Frontend UI recommendations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When implementing the frontend for air express search, use the following workflow:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Primary view: Display the non-stop itineraries returned by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS"]}," search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User override: Provide a clear UI element (e.g., a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show all flights"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable extended results"]}," action button)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Action: Link this UI element to a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/airapi/air/airsearch"},"children":["get air itineraries"]}," API call with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchMode"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPRESS_EXTENDED"]},". This ensures the users can still access the full inventory if the express results do not meet their needs."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/docs/assets/air-express-search.d8ae0080f30f29f2a7c36e9e741c587727f57d6a99fa4a66f6490ba05fe6e401.9c1bb791.png","alt":"Tax inclusion sample image","withLightbox":false,"width":"100%","height":"100%","align":"center","border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"SmallCenter","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fig:"]}," UI elements on Spotnana OBT to override air express search results."]}]}]}]},"headings":[{"value":"Air express search","id":"air-express-search","depth":1},{"value":"Feature overview","id":"feature-overview","depth":2},{"value":"Key benefits","id":"key-benefits","depth":2},{"value":"Integration procedure","id":"integration-procedure","depth":2},{"value":"1. Prerequisites","id":"1-prerequisites","depth":3},{"value":"2. API implementation","id":"2-api-implementation","depth":3},{"value":"3. Threshold and fallback mechanism","id":"3-threshold-and-fallback-mechanism","depth":3},{"value":"4. Pagination","id":"4-pagination","depth":3},{"value":"5. Frontend UI recommendations","id":"5-frontend-ui-recommendations","depth":3}],"frontmatter":{"seo":{"title":"Air express search"}},"lastModified":"2026-02-04T13:02:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/air_guides/air_express_search_guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}