> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/hotel/api/api-hotel-property.md).

# API Hotel Property

Endpoint: `content/property`

Content đầy đủ của một khách sạn. Master không tồn tại trả `29 PROPERTY_NOT_FOUND`.

**Request**

| Field      | Kiểu            | Bắt buộc | Mô tả        |
| ---------- | --------------- | -------- | ------------ |
| `masterId` | string (chữ số) | ✔        | Id khách sạn |
| `language` | enum            |          | `vi` \| `en` |

```json
{ "masterId": "30715", "language": "vi" }
```

**Response** — `Property` đầy đủ. Content **không có thông tin liên hệ trực tiếp của khách sạn**.

| Field                                       | Kiểu   | Mô tả                                                                                                                                                                                                                         |
| ------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `masterId`, `name`, `latitude`, `longitude` |        | Như `content/properties`                                                                                                                                                                                                      |
| `address`                                   | object | `line`, `line2`, `city`, `province`, `postalCode`, `country` (alpha-2), `countryName`                                                                                                                                         |
| `propertyType`                              | string | Ví dụ `Khách sạn`, `Căn hộ`                                                                                                                                                                                                   |
| `starRating`                                | number | Ví dụ `4.5`                                                                                                                                                                                                                   |
| `guestRating`                               | object | `score`, `count`, `recommendationPercent`, `overall`, `cleanliness`, `service`, `comfort`, `condition`, `location`, `neighborhood`, `quality`, `value`, `amenities` — tất cả là chuỗi. Field nào nguồn không có thì không trả |
| `checkin`                                   | object | `{ from, to }`, ví dụ `14:00` – `23:00`                                                                                                                                                                                       |
| `checkout`                                  | object | `{ until }`, ví dụ `12:00`                                                                                                                                                                                                    |
| `checkinTime`, `checkoutTime`               | string | Bằng `checkin.from` / `checkout.until`; giữ cho đối tác đã tích hợp bản 1.0.0                                                                                                                                                 |
| `descriptions[]`, `policies[]`, `fees[]`    | array  | `{ type, text }`; `text` có thể chứa HTML đơn giản                                                                                                                                                                            |
| `amenities[]`                               | array  | `{ id, name, group }`                                                                                                                                                                                                         |
| `themes[]`, `spokenLanguages[]`             | array  |                                                                                                                                                                                                                               |
| `statistics[]`                              | array  | `{ name, value }` — số tầng, số phòng…                                                                                                                                                                                        |
| `images[]`                                  | array  | `{ url, caption, position }`                                                                                                                                                                                                  |
| `roomTypes[]`                               | array  | Tối đa 4 loại phòng tiêu biểu                                                                                                                                                                                                 |

```json
{
  "masterId": "30715",
  "name": "Khách sạn Mẫu Đà Nẵng",
  "propertyType": "Khách sạn",
  "starRating": 4,
  "guestRating": { "score": "8.6", "count": 1245, "cleanliness": "8.8", "location": "9.1" },
  "address": {
    "line": "12 Võ Nguyên Giáp", "city": "Đà Nẵng",
    "country": "VN", "countryName": "Việt Nam"
  },
  "latitude": 16.0612,
  "longitude": 108.2471,
  "checkin": { "from": "14:00", "to": "23:00" },
  "checkout": { "until": "12:00" },
  "checkinTime": "14:00",
  "checkoutTime": "12:00",
  "descriptions": [{ "type": "overview", "text": "Khách sạn 4 sao ven biển Mỹ Khê…" }],
  "policies": [{ "type": "pets", "text": "Không nhận thú cưng." }],
  "fees": [{ "type": "mandatory", "text": "Phí phục vụ 5% đã gồm trong giá." }],
  "amenities": [{ "id": "WIFI", "name": "Wifi miễn phí", "group": "Internet" }],
  "themes": ["Gia đình", "Biển"],
  "spokenLanguages": ["vi", "en"],
  "statistics": [{ "name": "Số phòng", "value": "180" }],
  "images": [
    { "url": "https://cdn.example.com/30715/1.jpg", "caption": "Mặt tiền", "position": 1 }
  ],
  "roomTypes": [{
    "roomTypeId": "DLX",
    "name": "Deluxe hướng biển",
    "descriptions": ["Phòng 32m² có ban công nhìn ra biển."],
    "areaSquareMeters": 32,
    "views": ["Hướng biển"],
    "bedTypes": ["1 giường đôi"],
    "maxOccupancy": 3, "maxAdults": 2, "maxChildren": 1,
    "images": [{ "url": "https://cdn.example.com/30715/dlx-1.jpg" }],
    "amenities": [{ "id": "BATHTUB", "name": "Bồn tắm", "group": "Phòng tắm" }]
  }]
}
```

{% hint style="warning" %}
`roomTypes` chỉ là **tối đa 4 loại phòng tiêu biểu** (trùng tên chỉ giữ một), không phải toàn bộ phòng. `roomTypeId` ở đây lấy theo nguồn content ưu tiên và **có thể khác** `roomTypeId` trong `offers` — **không ghép** offer với room content theo id.
{% endhint %}
