> 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/english/b2b2c-partner/api-method/hotel-1/api/api-hotel-property.md).

# API Hotel Property

Endpoint: `content/property`

Full content for one hotel. A non-existent master returns `29 PROPERTY_NOT_FOUND`.

**Request**

| Field      | Type            | Required | Description  |
| ---------- | --------------- | -------- | ------------ |
| `masterId` | string (digits) | ✔        | Hotel id     |
| `language` | enum            |          | `vi` \| `en` |

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

**Response** — the full `Property`. Content carries **no direct hotel contact details**.

| Field                                       | Type   | Description                                                                                                                                                                                                            |
| ------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `masterId`, `name`, `latitude`, `longitude` |        | As in `content/properties`                                                                                                                                                                                             |
| `address`                                   | object | `line`, `line2`, `city`, `province`, `postalCode`, `country` (alpha-2), `countryName`                                                                                                                                  |
| `propertyType`                              | string | e.g. `Hotel`, `Apartment`                                                                                                                                                                                              |
| `starRating`                                | number | e.g. `4.5`                                                                                                                                                                                                             |
| `guestRating`                               | object | `score`, `count`, `recommendationPercent`, `overall`, `cleanliness`, `service`, `comfort`, `condition`, `location`, `neighborhood`, `quality`, `value`, `amenities` — all strings. Fields the source lacks are omitted |
| `checkin`                                   | object | `{ from, to }`, e.g. `14:00` – `23:00`                                                                                                                                                                                 |
| `checkout`                                  | object | `{ until }`, e.g. `12:00`                                                                                                                                                                                              |
| `checkinTime`, `checkoutTime`               | string | Equal to `checkin.from` / `checkout.until`; kept for partners integrated against 1.0.0                                                                                                                                 |
| `descriptions[]`, `policies[]`, `fees[]`    | array  | `{ type, text }`; `text` may contain simple HTML                                                                                                                                                                       |
| `amenities[]`                               | array  | `{ id, name, group }`                                                                                                                                                                                                  |
| `themes[]`, `spokenLanguages[]`             | array  |                                                                                                                                                                                                                        |
| `statistics[]`                              | array  | `{ name, value }` — floors, room count…                                                                                                                                                                                |
| `images[]`                                  | array  | `{ url, caption, position }`                                                                                                                                                                                           |
| `roomTypes[]`                               | array  | Up to 4 representative room types                                                                                                                                                                                      |

```json
{
  "masterId": "30715",
  "name": "Sample Hotel Da Nang",
  "propertyType": "Hotel",
  "starRating": 4,
  "guestRating": { "score": "8.6", "count": 1245, "cleanliness": "8.8", "location": "9.1" },
  "address": {
    "line": "12 Vo Nguyen Giap", "city": "Da Nang",
    "country": "VN", "countryName": "Vietnam"
  },
  "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": "A 4-star beachfront hotel on My Khe beach…" }],
  "policies": [{ "type": "pets", "text": "Pets are not allowed." }],
  "fees": [{ "type": "mandatory", "text": "5% service charge is included in the rate." }],
  "amenities": [{ "id": "WIFI", "name": "Free Wi-Fi", "group": "Internet" }],
  "themes": ["Family", "Beach"],
  "spokenLanguages": ["vi", "en"],
  "statistics": [{ "name": "Number of rooms", "value": "180" }],
  "images": [
    { "url": "https://cdn.example.com/30715/1.jpg", "caption": "Facade", "position": 1 }
  ],
  "roomTypes": [{
    "roomTypeId": "DLX",
    "name": "Deluxe Ocean View",
    "descriptions": ["32 m² room with a balcony facing the sea."],
    "areaSquareMeters": 32,
    "views": ["Ocean view"],
    "bedTypes": ["1 double bed"],
    "maxOccupancy": 3, "maxAdults": 2, "maxChildren": 1,
    "images": [{ "url": "https://cdn.example.com/30715/dlx-1.jpg" }],
    "amenities": [{ "id": "BATHTUB", "name": "Bathtub", "group": "Bathroom" }]
  }]
}
```

{% hint style="warning" %}
`roomTypes` holds **at most 4 representative room types** (duplicates by name are collapsed), not the hotel's full inventory. Its `roomTypeId` comes from the preferred content source and **may differ** from `roomTypeId` in `offers` — **do not join** offers to room content by id.
{% endhint %}
