{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/stays/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Return Additional Search Results","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":"return-additional-search-results","__idx":0},"children":["Return Additional Search Results"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In all use cases, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actor"]}," is the developer implementing the interface between the TripServices APIs and your company's application that provides travel results to your company's end users. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actors"]}," here are not searching/booking travel for themselves but instead are implementing this data handling for input from your company's travel customers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"scope","__idx":1},"children":["Scope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This use case details how to retrieve an additional page of search results when a search finds more than 100 properties. This process is called pagination."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prerequisites"},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/getting-started/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Either:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v11: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/use-cases/searching-for-stays/search-by-airport"},"children":["Search"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v12: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/use-cases/searching-for-stays/search-by-airport"},"children":["SearchComplete"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["To proceed with booking:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v11: Search results must be followed by an Availability request and a Create Reservation request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v12: SearchComplete results must be followed by the Create Reservation request."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-v12-searchcomplete-api","__idx":2},"children":["Use case v12: SearchComplete API"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/guides/stays-search-guide"},"children":["TripServices Stays APIs Guide"]}," for more about the Hotel Search APIs and which to use after v12 is released."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Goals and steps"},"children":["Goals and steps"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code Example"},"children":["Code Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additional search results are available only if the search returns more than 100 properties, as indicated by a value greater than 100 in pagination/totalItems. If totalItems returns a value less than 100, you may be able to return additional results by resending your SearchComplete request with less strict search criteria, such as by increasing the radius around your search point or, if searching by chain codes, increasing the number of chain codes sent."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the  SearchComplete Pagination request endpoint, per the following example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["a. Send the value returned in the preceding SearchComplete response in pagination/paginationToken.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"b. Send the pageNumber query parameter set to the next page of results to retrieve."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the SearchComplete response doesn't return paginationToken, all available search results are returned in the initial response, and pagination is not available."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GET",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"https://api.travelport.com/12/hotel/search/searchcomplete/8f81930b-b5c5-4188-9bb6-d21ca2570dae?pageNumber=2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response returns the next page of search results using the standard SearchComplete v12 response format. The response indicates that this is the second page of search results."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"pagination\": {",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\"page\": 2,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\"pageSize\": 100,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\"totalPages\": 5,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\"totalItems\": 470,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\"paginationToken\": \"ec044728-a0bd-4757-bbd3-af9506060082\"",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"},"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-v11-search-by-location-or-id-api","__idx":3},"children":["Use case v11: Search by Location or ID API"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the TripServices Stays ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/guides/stays-search-guide"},"children":["APIs Guide"]}," for more about the Hotel Search APIs and which to use after v12 is released."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Goals and steps"},"children":["Goals and steps"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code Example"},"children":["Code Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additional search results are available only if the search returns more than 100 properties, as indicated by a value greater than 100 in Properties/totalProperties.  If totalProperties returns a value less than 100, you may be able to return additional results by resending your Search by Location request with less strict search criteria, such as by increasing the radius around your search point. For Search by ID, add more property keys to your request."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the  Search Pagination request endpoint, per the following example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["a. Send the value returned in the preceding search response in Properties/Identifier/value.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"b. Send the pageNumber query parameter set to the next page of results to retrieve."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the SearchComplete response doesn't return paginationToken, all available search results are returned in the initial response, and pagination is not available."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GET",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"https://api.travelport.com/11/hotel/search/properties/b461b27d-5ca2-4387-a1b2-7d5ca263873d?pageNumber=2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response returns the next page of search results using the standard Search v11 response format. The response does not indicate what page of search results is returned."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None applicable."]}]}]}]}]}]},"headings":[{"value":"Return Additional Search Results","id":"return-additional-search-results","depth":1},{"value":"Scope","id":"scope","depth":4},{"value":"Use case v12: SearchComplete API","id":"use-case-v12-searchcomplete-api","depth":4},{"value":"Use case v11: Search by Location or ID API","id":"use-case-v11-search-by-location-or-id-api","depth":4}],"frontmatter":{"seo":{"title":"Return Additional Search Results"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/stays/use-cases/searching-for-stays/return-additional-search-results","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}