> 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-content-properties.md).

# API Content Properties

Endpoint: `content/properties`

**Active** masters in one country, walked by cursor. Each hotel carries only `masterId`, `name`, `address`, `latitude`, `longitude` — call `content/property` for full content.

Re-call with `cursor = nextCursor` until `nextCursor` is `null`.

**Request**

| Field         | Type      | Required | Description                                                                                         |
| ------------- | --------- | -------- | --------------------------------------------------------------------------------------------------- |
| `countryCode` | string(2) | ✔        | ISO 3166-1 alpha-2, e.g. `VN`                                                                       |
| `provider`    | enum      |          | `ALL` (default), `HMS`, `SUPPLIER`. A master available from both sources appears under both filters |
| `size`        | int       |          | 1–500, default 100                                                                                  |
| `cursor`      | string    |          | `nextCursor` of the previous page; omit on the first page                                           |
| `language`    | enum      |          | `vi` \| `en`                                                                                        |

```json
{ "countryCode": "VN", "provider": "ALL", "size": 100, "language": "en" }
```

**Response**

| Field          | Type           | Description                            |
| -------------- | -------------- | -------------------------------------- |
| `properties[]` | array          | Condensed hotel list                   |
| `nextCursor`   | string \| null | `null` when the catalogue is exhausted |

```json
{
  "properties": [
    {
      "masterId": "30715",
      "name": "Sample Hotel Da Nang",
      "address": {
        "line": "12 Vo Nguyen Giap", "city": "Da Nang",
        "province": "Da Nang", "country": "VN"
      },
      "latitude": 16.0612,
      "longitude": 108.2471
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjEwMH0"
}
```

{% hint style="warning" %}
As of 1.1.0, `content/properties` **no longer accepts `masterIds`**, `page`, `total` or `modifiedSince`. Walk the catalogue with `cursor`; fetch a single hotel's details from `content/property`.
{% endhint %}
