Table of Contents

City Feeds API Documentation

Overview

This API returns a list ALL of cities (or regions) with active hotels.


API Endpoint

  • URL: {{host}}/hub/b2c/hotel/feeds/city
  • Method: GET

Request Body

No request body required for GET method


Sample Request

curl --location --request GET '{{host}}/hub/b2c/hotel/feeds/city' \


Sample Response

[
  {
    "name": "Tuy Phong",
    "nameVN": "Tuy Phong",
    "countryCode": "vn",
    "longitude": 108.71667,
    "latitude": 11.23333,
    "activeHotels": 10
  },
  {
    "name": "Cu Chi",
    "nameVN": "Củ Chi",
    "countryCode": "vn",
    "longitude": 106.4667,
    "latitude": 10.9667,
    "activeHotels": 1
  },
  {
    "name": "Hung Yen",
    "nameVN": "Hưng Yên",
    "countryCode": "vn",
    "longitude": 106.0667,
    "latitude": 20.65,
    "activeHotels": 17
  }
]

Response Field Description

City Feeds Object

Field Type Example Description
name String "Cu Chi" name of city
nameVN String "Củ Chi" name of city as Vietnamese
countryCode String "vn" country
longitude decimal 106.4667 longitude of city
latitude decimal 10.9667 latitude of city
activeHotels int 1 number of hotels are active

Country Code Reference

Code Name
vn Vietnam
... ...

Notes

The API can be used to suggest autocomplete locations, or used in maps to show areas with hotels.

The nameVN names serve the Vietnamese interface, name is for the international version.