Destination Search API Documentation

Overview

This API is used to search hotel for destinations based on the location name input by the user. The returned results include detailed information about various places such as museums, squares, or landmarks in different provinces.

---

API Endpoint

• URL: {{host}}/hub/b2c/hotel/destination/search
• Method: POST
• Content-Type: application/json

---

Headers

Key	Value	Description
Content-Type	application/json	Response format
Authorization	Bearer {token}	access token

---

Request Body

{
  "destination": "Hồ Chí Minh"
}

---

Request Field Description

Field	Type	Required	Description
destination	string	✅	Name of the location to search (có dấu)

Sample Request

curl --location '{{host}}/hub/b2c/hotel/destination/search' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
    "destination": "Hồ Chí Minh"
}'

---

Sample Response

{
  "destinations": [
    {
      "providerCode": "hotel.provider1",
      "destinationId": "6334955",
      "name": "Ho Chi Minh Square",
      "nameVN": "Quảng trường Hồ Chí Minh",
      "destinationType": "point_of_interest",
      "countryCode": "VN",
      "address": "Ho Chi Minh Square, Vinh, Nghe An Province, Vietnam",
      "addressVN": "Quảng trường Hồ Chí Minh, Vinh, Nghệ An (tỉnh), Việt Nam",
      "location": {
        "latitude": 18.670763,
        "longitude": 105.690878
      }
    },
    {
      "providerCode": "hotel.provider1",
      "destinationId": "6223115",
      "name": "Ho Chi Minh Museum",
      "nameVN": "Bảo tàng Hồ Chí Minh",
      "destinationType": "point_of_interest",
      "countryCode": "VN",
      "address": "Ho Chi Minh Museum, Pleiku, Gia Lai Province, Vietnam",
      "addressVN": "Bảo tàng Hồ Chí Minh, Pleiku, Gia Lai (tỉnh), Việt Nam",
      "location": {
        "latitude": 13.986353,
        "longitude": 108.006098
      }
    },
    {
      "providerCode": "hotel.provider1",
      "destinationId": "5130067",
      "name": "Ho Chi Minh City (SGN-Tan Son Nhat Intl.)",
      "nameVN": "Thành phố Hồ Chí Minh (SGN-Sân bay quốc tế Tân Sơn Nhất)",
      "destinationType": "airport",
      "countryCode": "VN",
      "address": "Ho Chi Minh City, Vietnam (SGN-Tan Son Nhat Intl.)",
      "addressVN": "Thành phố Hồ Chí Minh, Việt Nam (SGN-Sân bay quốc tế Tân Sơn Nhất)",
      "location": {
        "latitude": 10.813263,
        "longitude": 106.662118
      }
    }
  ]
}

---

Response Field Description

Root Object

Field	Type	Description
destinations	array	List of matching destinations for the keyword

---

Destination Object

Field	Type	Example	Description
providerCode	string	hotel.provider1	Supplier/provider code
destinationId	string	6334955	Unique ID of the destination
name	string	Ho Chi Minh Square	Name of the place (in English)
nameVN	string	Quảng trường Hồ Chí Minh	Name of the place (in Vietnamese)
destinationType	string	point_of_interest	Type of destination (point_of_interest, etc.)
countryCode	string	VN	Country code (ISO standard)
address	string	Ho Chi Minh Square, Vinh, ...	Full address (in English)
addressVN	string	Quảng trường Hồ Chí Minh, Vinh, ...	Full address (in Vietnamese)
location	object	{ "latitude": 18.67, "longitude": 105.69 }	Geographic coordinates (latitude & longitude)

---

Country Code Reference

Code	Country Name
VN	Vietnam
IN	India
TH	Thailand
US	United States
...	...

---

Notes

The API return multiple locations