{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/stays/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Search by airport","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":"search-by-airport","__idx":0},"children":["Search by airport"]},{"$$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 a search request for properties within a specified radius around Charles de Gaulle airport (IATA code ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["CDG"]},")."]},{"$$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":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","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. SearchComplete is not yet available to customers."]}]},{"$$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":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the SearchComplete request payload, provide the required location details for the airport - we'll send the code ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["CDG"]}," for Charles de Gaulle airport in Paris:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["type value of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["airportIATACode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["IATA airport code value ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["CDG"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search radius around that city"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional: Specify either ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["mi"]}," or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["km"]}," for the unit of measure for the search radius"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must also provide these additional required details (not shown in this example):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["check in and out dates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["guest count"]}]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"propertyFilter\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"location\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"type\": \"airportIATACode\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"details\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"iataCode\": \"CDG\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"radius\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": 5,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"unit\": \"mi\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on availability and search criteria, SearchComplete returns several instances of the object ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hotelsResponse/propertyItems"]},". Each instance of propertyItems is a specific room available at a specified rate. In each instance, the property location is returned in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["propertyInfo"]}," object, which returns multiple types of geographic details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["geolocation (coordinates of the property for this room)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["distanceFromSearchPoint (in miles or kilometers as specified in the search)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["address - per the example, this hotel is located in Paris"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"propertyInfo\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"geolocation\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"center\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"latitude\": 48.8714,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"longitude\": 2.3434"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"distanceFromSearchPoint\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"unitOfDistance\": \"Miles\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": 0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"address\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"street\": \"30-32 BOULEVARD POISSONNI RE\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"city\": \"PARIS\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"countryCode\": \"FR\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"postalCode\": \"75009\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-v11-search-by-location-api","__idx":3},"children":["Use case v11: Search by Location 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."]}]},{"$$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":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"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":"p","attributes":{},"children":["To search by airport:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Search by Location request payload, provide the required location details for the airport:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["discriminator @type of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["SearchByAirport"]}," for the SearchBy object"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["IATA airport code ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["CDG"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search radius around the airport"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify either ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Miles"]}," or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Kilometers"]}," as the unit of measure for the search radius"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must also provide these additional required details in these objects (not shown in the code example):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["check in and out dates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["guest count"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the request to the Search by Location API endpoint."]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"SearchBy\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"SearchByAirport\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"SearchRadius\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": 25,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"unitOfDistance\": \"Miles\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"SearchAirport\": \"CDG\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on availability and search criteria, the Search by Location API returns several instances of the object ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Properties/PropertyInfo"]},". Each instance of PropertyInfo is a specific room available at a specified rate. In each instance, the property location is returned in the GeoLocation and Address objects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per the example, location data shows the geographic coordinates and hotel address in Paris."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"GeoLocation\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"latitude\": 48.8714,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"longitude\": 2.3434"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Image\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{...}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["],"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Address\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"Address\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"AddressLine\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"30-32 BOULEVARD POISSONNI RE\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["],"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"City\": \"PARIS\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Country\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": \"FR\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"PostalCode\": \"75009\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Telephone\": [...],"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]}]}]}]}]}]}]},"headings":[{"value":"Search by airport","id":"search-by-airport","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 API","id":"use-case-v11-search-by-location-api","depth":4}],"frontmatter":{"seo":{"title":"Search by airport"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/stays/use-cases/searching-for-stays/search-by-airport","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}