---
title: "Autocomplete for geographical locations - used to power customer location auto completes."
method: POST
path: "/autocomplete"
tags: ["Data"]
---

# Autocomplete for geographical locations - used to power customer location auto completes.

`POST /autocomplete`

## Query parameters

- `Query` string
- `CountryCode` string
- `BlockCountryCode` string
- `TopQuery` string
- `SearchType` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 — Enumerator defining type of search:<br>1=Flights, 2=Accommodation, 3=Packages, 4=TicketsAttractions, 5=Transfers, 6=AirportExtras, 7=Insurance, 8=CarRental, 9=Visas, 10=Tours, 11=DynamicPackaging, 12=CustomExtra, 13=Cruise, 14=TicketAccommodation, 15=TicketAccommodationFlight
- `GeographyType` 1 | 2 | 3 | 4 | 5 | 6 — Enumerator defining type of a geographical place:<br>1=Country, 2=City, 3=Airport, 4=PointOfInterest, 5=Property, 6=Port
- `LinkGeography` 1 | 2 | 3 | 4 | 5 | 6 — Enumerator defining type of a geographical place:<br>1=Country, 2=City, 3=Airport, 4=PointOfInterest, 5=Property, 6=Port
- `LinkId` string
- `MinStarRating` number, double
- `BlockLevel` integer
- `ListID` integer
- `Split` boolean
- `IsLocListAdmin` boolean
- `Numeric` boolean
- `Language` string, required
- `MaxItems` integer
- `ShowSupplier` boolean

## Response `200`

Success - returns the list of matching geographical locations.

- Geography[]
  - `id` string, nullable — Unique geography identifier (id:type).
  - `isValidated` boolean, nullable — If location is validated (internal use only).
  - `type` 1 | 2 | 3 | 4 | 5 | 6 — Enumerator defining type of a geographical place:<br>1=Country, 2=City, 3=Airport, 4=PointOfInterest, 5=Property, 6=Port
  - `name` string, nullable — Name of location.
  - `parentName` string, nullable — Name of location.
  - `countryCode` string, nullable — 2-letter country code.
  - `iataCode` string, nullable — 3-letter airport or city code.
  - `iataCity` string, nullable — 3-letter city code.
  - `iataGroupCodes` string, nullable — Comma-delimited list of group codes
  - `latitude` number, double — Latitude of location.
  - `longitude` number, double — Longitude of location.
  - `priority` integer — Priority of location.
  - `priorityOriginal` integer — Original priority (unmodified by matching algorithm)
  - `gmtOffset` integer — GMT time offset.
  - `distanceOverride` number, double, nullable — Distance/radius override (miles).
  - `rating` number, double, nullable — Star rating (if property)
  - `ref` string, nullable — Unique reference (if property).
  - `imageUrl` string, nullable — Optional image url.
  - `summary` string, nullable — Optional summary description.
  - `eventDate` string, date-time, nullable — Event date (if event).
  - `eventEndDate` string, date-time, nullable — Event end date (if event).
  - `daysBefore` integer, nullable — Optional days before setting.
  - `nights` integer, nullable — Optional nights setting.
  - `settings` object, nullable — Optional array of additional settings.
  - `mappings` object, nullable — Array of mappings for location.
    - `Unknown` string
    - `HitchHiker` string
    - `GoldMedalDNATA` string
    - `HotelBeds` string
    - `Ingresso` string
    - `Hoppa` string
    - `HolidayExtras` string
    - `FlexibleAutos` string
    - `AvisBudget` string
    - `VisaHQ` string
    - `EAN` string
    - `Insightly` string
    - `Tiqets` string
    - `HolidayTaxis` string
    - `GAdventures` string
    - `GoogleAnalytics` string
    - `Homestay` string
    - `ApartmentsApart` string
    - `Mailchimp` string
    - `Interhome` string
    - `DemoFlights` string
    - `TravelifyComparison` string
    - `SygicData` string
    - `DemoCarRental` string
    - `DemoTickets` string
    - `Leezair` string
    - `Traveltek` string
    - `YpsilonFlights` string
    - `Paxport` string
    - `Stripe` string
    - `Braintree` string
    - `ArrivalGuides` string
    - `WalkScore` string
    - `Encharge` string
    - `MailerLite` string
    - `DemoTransfer` string
    - `DemoAirportExtras` string
    - `AttractionWorld` string
    - `Square` string
    - `Impala` string
    - `PayPal` string
    - `SolmarVillas` string
    - `GFAHub` string
    - `Hubspot` string
    - `Zapier` string
    - `RateHawk` string
    - `Musement` string
    - `Intuitive` string
    - `ManualPayments` string
    - `eMerchantPay` string
    - `Worldpay` string
    - `GoGlobal` string
    - `TBO` string
    - `Carnect` string
    - `Yalago` string
    - `TIG` string
    - `RadicalStorage` string
    - `Penguin` string
    - `BlueInsurance` string
    - `Opayo` string
    - `Dolphin` string
    - `Jet2` string
    - `Felloh` string
    - `Barclaycard` string
    - `GoogleSheets` string
    - `FlyNowPayLater` string
    - `Travelify` string
    - `Tarsc` string
    - `EcommPay` string
    - `TrustPayments` string
    - `GetResponse` string
    - `Cardstream` string
    - `TripSolutions` string
    - `Innstant` string
    - `Bookabed` string
    - `JumboTours` string
    - `DOTW` string
    - `SunHotels` string
    - `PTSCloud` string
    - `Teldar` string
    - `TripAdvisor` string
    - `RePUSHTI` string
    - `Albena` string
    - `JTA` string
    - `APH` string
    - `What3words` string
    - `Moretrees` string
    - `Ecologi` string
    - `OTS` string
    - `Duffel` string
    - `Smyrooms` string
    - `Shareasale` string
    - `Sendy` string
    - `Feefo` string
    - `ConstantContact` string
    - `Webhook` string
    - `RoadGoat` string
    - `Tripian` string
    - `Olympic` string
    - `Skistar` string
    - `iTravex` string
    - `Suntransfers` string
    - `Afterpay` string
    - `Dixa` string
    - `CCAvenue` string
    - `AIBMS` string
    - `Seon` string
    - `Clicky` string
    - `Telr` string
    - `Zoho` string
    - `Etihad` string
    - `Advantage` string
    - `GetAddress` string
    - `Brightsun` string
    - `Hotelplanner` string
    - `USAePay` string
    - `ReePay` string
    - `Mondee` string
    - `VisitGroup` string
    - `SKAPIT` string
    - `Faremine` string
    - `ITSGroup` string
    - `MyFatoorah` string
    - `EveryHoliday` string
    - `ChatGPT` string
    - `Rewardful` string
    - `FlutterWave` string
    - `Decta` string
    - `Liftie` string
    - `HighLevelCRM` string
    - `DidaTravel` string
    - `Altura` string
    - `RMI` string
    - `Tixstock` string
    - `HNHolidays` string
    - `CurrencyExchange` string
    - `Evolvi` string
    - `Darina` string
    - `Klaviyo` string
    - `AerTicket` string
    - `ProtectGroup` string
    - `GoogleLogin` string
    - `VivaPayments` string
    - `Widgety` string
    - `Xs2Event` string
    - `Whapi` string
    - `CurrencyConverterAPI` string
    - `Pax2Pay` string
    - `TravelvogueAnex` string
    - `SingleSignOn` string
    - `TTSS` string
    - `SerpApi` string
    - `GlobalPay` string
    - `PKFare` string
    - `PierreVacances` string
    - `MercuryHolidays` string
    - `SunshineTech` string
    - `TUI` string
    - `NowPayments` string
    - `Stuba` string
    - `Skiset` string
    - `Easemytrip` string
    - `LiftsTo` string
    - `Jonview` string
    - `SinGSTravel` string
    - `PayFast` string
    - `IVectorConnect` string
    - `ZestCarRental` string
    - `BarclaysFuse` string
    - `MajorTravel` string
    - `Travelpack` string
    - `MintPayments` string
    - `TravelWorks` string
    - `Atlas` string
    - `Custom` string
    - `IdealPostcodes` string
    - `Paximum` string
    - `Webhotelier` string
    - `TTNG` string
    - `SportsEvents365` string
    - `Brevo` string
    - `TGContracting` string
    - `Amitour` string
    - `TotalProcessing` string
    - `InComm` string
    - `Intercom` string
  - `supplier` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 — Enumerator defining supplier types:<br>0=Unknown, 1=HitchHiker, 2=GoldMedalDNATA, 3=HotelBeds, 4=Ingresso, 5=Hoppa, 6=HolidayExtras, 7=FlexibleAutos, 8=AvisBudget, 9=VisaHQ, 10=EAN, 11=Insightly, 12=Tiqets, 13=HolidayTaxis, 14=GAdventures, 15=GoogleAnalytics, 16=Homestay, 17=ApartmentsApart, 18=Mailchimp, 19=Interhome, 20=DemoFlights, 21=TravelifyComparison, 22=SygicData, 23=DemoCarRental, 24=DemoTickets, 25=Leezair, 26=Traveltek, 27=YpsilonFlights, 28=Paxport, 29=Stripe, 30=Braintree, 31=ArrivalGuides, 32=WalkScore, 33=Encharge, 34=MailerLite, 35=DemoTransfer, 36=DemoAirportExtras, 37=AttractionWorld, 38=Square, 39=Impala, 40=PayPal, 41=SolmarVillas, 42=GFAHub, 43=Hubspot, 44=Zapier, 45=RateHawk, 46=Musement, 47=Intuitive, 48=ManualPayments, 49=eMerchantPay, 50=Worldpay, 51=GoGlobal, 52=TBO, 53=Carnect, 54=Yalago, 55=TIG, 56=RadicalStorage, 57=Penguin, 58=BlueInsurance, 59=Opayo, 60=Dolphin, 61=Jet2, 62=Felloh, 63=Barclaycard, 64=GoogleSheets, 65=FlyNowPayLater, 66=Travelify, 67=Tarsc, 68=EcommPay, 69=TrustPayments, 70=GetResponse, 71=Cardstream, 72=TripSolutions, 73=Innstant, 74=Bookabed, 75=JumboTours, 76=DOTW, 77=SunHotels, 78=PTSCloud, 79=Teldar, 80=TripAdvisor, 81=RePUSHTI, 82=Albena, 83=JTA, 84=APH, 85=What3words, 86=Moretrees, 87=Ecologi, 88=OTS, 89=Duffel, 90=Smyrooms, 91=Shareasale, 92=Sendy, 93=Feefo, 94=ConstantContact, 95=Webhook, 96=RoadGoat, 97=Tripian, 98=Olympic, 99=Skistar, 100=iTravex, 101=Suntransfers, 102=Afterpay, 103=Dixa, 104=CCAvenue, 105=AIBMS, 106=Seon, 107=Clicky, 108=Telr, 109=Zoho, 110=Etihad, 111=Advantage, 112=GetAddress, 113=Brightsun, 114=Hotelplanner, 115=USAePay, 116=ReePay, 117=Mondee, 118=VisitGroup, 119=SKAPIT, 120=Faremine, 121=ITSGroup, 122=MyFatoorah, 123=EveryHoliday, 124=ChatGPT, 125=Rewardful, 126=FlutterWave, 127=Decta, 128=Liftie, 129=HighLevelCRM, 130=DidaTravel, 131=Altura, 132=RMI, 133=Tixstock, 134=HNHolidays, 135=CurrencyExchange, 136=Evolvi, 137=Darina, 138=Klaviyo, 139=AerTicket, 140=ProtectGroup, 141=GoogleLogin, 142=VivaPayments, 143=Widgety, 144=Xs2Event, 145=Whapi, 146=CurrencyConverterAPI, 147=Pax2Pay, 148=TravelvogueAnex, 149=SingleSignOn, 150=TTSS, 151=SerpApi, 152=GlobalPay, 153=PKFare, 154=PierreVacances, 155=MercuryHolidays, 156=SunshineTech, 157=TUI, 158=NowPayments, 159=Stuba, 160=Skiset, 161=Easemytrip, 162=LiftsTo, 163=Jonview, 164=SinGSTravel, 165=PayFast, 166=IVectorConnect, 167=ZestCarRental, 168=BarclaysFuse, 169=MajorTravel, 170=Travelpack, 171=MintPayments, 172=TravelWorks, 173=Atlas, 174=Custom, 175=IdealPostcodes, 176=Paximum, 177=Webhotelier, 178=TTNG, 179=SportsEvents365, 180=Brevo, 181=TGContracting, 182=Amitour, 183=TotalProcessing, 184=InComm, 185=Intercom
  - `subLocations` Geography[], nullable — Optional list of sub-locations
  - `translations` object, nullable — Translations (only used internally)

## Other responses

- `400` — Bad request - check the response message for what information is missing or incorrect.

---

[API](https://skmtc.dev/travelify/apis/travelify-io-api.md) · [All operations](https://skmtc.dev/travelify/apis/travelify-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/travelify/travelify-io-api/revisions/b09ce3f0c6d5/schema)
