Get hotel list

post

https://open.fusionconnectgroup.com/openapi/v1/glink/search/hotelList

Overview

Search hotels for a resolved destination and stay dates. This is the discovery step in the Lightweight Integration Flow.

When to use

A traveler has selected a destination and dates.
The application needs list-page hotel candidates and filterable results.

What you get

Hotel list results with basic display information, location fields, and group or brand details when available.

Next steps

Hydrate a selected hotel with Query hotel basic information and Query hotel images. Query product in real time only when the traveler reaches the hotel detail or booking path.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Pass the business request body directly. Do not wrap it in header / businessRequest.

destinationId

string

Destination ID. Pass either destinationId or longitude/latitude. If both are provided, longitude/latitude take precedence.

lngGoogle

number

Google longitude, used for distance calculation.

latGoogle

number

Google latitude, used for distance calculation.

checkInDate

string

required

Check-in date in yyyy-MM-dd format.

checkOutDate

string

required

Check-out date in yyyy-MM-dd format.

priceBegin

number

Minimum price

priceEnd

number

Maximum price

hotelLabelIds

array of strings

Hotel label IDs

hotelLabelIds

hotelBrandCodes

array of strings

Hotel brand codes

hotelBrandCodes

plateCodes

array of strings

Group codes

plateCodes

hotelSubCategoryIds

array of strings

Hotel category IDs

hotelSubCategoryIds

hotelStars

array of strings

Hotel star ratings

hotelStars

hotelFacilityCodes

array of strings

Hotel facility codes

hotelFacilityCodes

roomFacilityCodes

array of strings

Room facility codes

roomFacilityCodes

language

string

Language. zh-CN for Chinese and en-US for English. Defaults to English.

keyWord

string

Hotel keyword name. Used to filter the hotel list by hotel name. This condition does not apply when destinationId points to a hotel.

distance

string

required

Distance range in km.

currentPage

integer

Current page. Defaults to page 1.

pageSize

integer

Page size. Defaults to 10 records per page.

sortBy

integer

Sort option: 1 - default; 2 - price low to high; 3 - price high to low; 4 - star rating high to low; 5 - star rating low to high; 6 - distance near to far; 7 - rating high to low. Default: 1.

Responses

200The platform has completed authentication and downstream forwarding. When code=SUCCESS, data contains the Glink business response object. Supplier business failures may still return HTTP 200 with code=SUPPLIER_BIZ_ERROR.

401Unified authentication failed. May return APP_KEY_INVALID, SIGN_ERROR, TIMESTAMP_EXPIRED, NONCE_REPLAY.

403Application status, product entitlement, vendor mapping, or IP whitelist verification failed.

404The interface route does not exist. Usually indicates a request method or path mismatch.

500Platform internal error.

502The downstream supplier is unavailable, the return structure is illegal, or the platform runtime adaptation fails.

504Downstream supplier timed out.