---
title: "Hotel Supplier Autocomplete"
method: GET
path: "/v2/hotel-supplier-autocomplete"
tags: ["Autocomplete"]
---

# Hotel Supplier Autocomplete

`GET /v2/hotel-supplier-autocomplete`

This endpoint provides autocomplete suggestions for hotels based on the query provided.

## Query parameters

- `query` string, required

## Response `200`

OK

- HotelAutocompleteResponse
  - `hotels` AutocompleteHotel[], required — List of Hotels matching the Autocomplete query
    - `hotelCode` string — Unique Code for the hotel
    - `hotelName` string, required — Full Name of the hotel
    - `location` Location — Location details
      - `countryCode` string — Unique country code for a location
      - `countryName` string — Full name of the country
      - `googlePlaceId` string — Unique place ID for the location assigned by Google
      - `latlong` Latlng — Latitude and Longitude for a Location
        - `latitude` number, double, required — Latitude of the Location
        - `longitude` number, double, required — Longitude of the Location
      - `name` string, required — Full name of the Location
      - `stateName` string — Full name of the state
    - `address` PostalAddress — Postal Address Details
      - `addressLines` string[], required — Address lines
      - `administrativeArea` string — Code of administrative area. For example: DL for Delhi, India. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.
      - `administrativeAreaName` string — Name of administrative area. This is full name corresponding to administrativeArea. Like Delhi for DL area code. For some places, code and name maybe same as well like Tokyo.
      - `description` string — Address description
      - `isDefault` boolean — Whether this address is default address in case multiple addresses are specified.
      - `languageCode` string — BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations. Examples: "zh-Hant", "ja", "ja-Latn", "en".
      - `locality` string — Generally refers to the city/town portion of the address.
      - `locationCode` string — IATA 3-letter location code. See https://www.iata.org/en/services/codes.
      - `organization` string — The name of the organization at the address.
      - `postalCode` string — Postal code of the address. This is a required field when setting for a user/legal entity/company etc.
      - `continentCode` string — 2 letter continent code of the continent this address falls in.
      - `recipients` string[] — The recipient at the address.
      - `regionCode` string, required — Region code of the country/region of the address.
      - `regionName` string — Region name of the country/region of the address.
      - `revision` integer
      - `sortingCode` string — Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
      - `sublocality` string — Sublocality of the address. This can be neighborhoods, boroughs, districts.
      - `timezone` string — Time zone of the address.
      - `coordinates` Latlng — Latitude and Longitude for a Location
        - `latitude` number, double, required — Latitude of the Location
        - `longitude` number, double, required — Longitude of the Location
    - `isPresentInPreferredVendors` boolean — Whether the hotel is present in preferred vendor list. This is an optional field which gets populated only in the preferred vendor autocomplete API.
    - `brandCode` string — The code of hotel brand.
    - `chainCode` string — The code of hotel chain.
    - `starRating` HotelStarRatingInfo — Details about hotel star rating.
      - `starRating` number, float, required — Star rating of the hotel.
      - `ratingType` 'OFFICIAL' | 'SELF_RATED', required — Enum representing the type of star rating.
    - `contactInfo` ContactInfo — Provides contact information for a hotel.
      - `phone` PhoneNumber[], required — List of phone numbers for the hotel.
        - `countryCode` integer — two digit country code
        - `countryCodeSource` 'UNSPECIFIED' | 'FROM_NUMBER_WITH_PLUS_SIGN' | 'FROM_NUMBER_WITH_IDD' | 'FROM_NUMBER_WITHOUT_PLUS_SIGN' | 'FROM_DEFAULT_COUNTRY'
        - `extension` string — phone number extension
        - `isoCountryCode` string — ISO alpha-2 code
        - `italianLeadingZero` boolean
        - `nationalNumber` integer
        - `numberOfLeadingZeros` integer
        - `preferredDomesticCarrierCode` string
        - `rawInput` string
        - `type` 'UNKNOWN_TYPE' | 'MOBILE' | 'LANDLINE'
      - `fax` string[] — List of fax numbers for the hotel.
      - `email` string[], required — List of email addresses for the hotel.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/spotnana/apis/hotel-api.md) · [All operations](https://skmtc.net/spotnana/apis/hotel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/hotel-api/revisions/34c735aa7110/schema)