The GetPropertyData query is the primary hotel content retrieval service within the Merchandising API.

It allows travel buyers to retrieve hotel-level merchandising and descriptive content. The GetPropertyData query returns hotel-level content only. Room-level content must be retrieved separately using the GetPropertyRoomData query.

Request Example

Query Variables

{
  "propertyIds": [126913],
  "limit": 1
}

Request

query GetPropertyData($propertyIds: [Long]) {
  GetPropertyData(propertyIds: $propertyIds) {
    meta {
      dataLoadType
      timestamp
      totalCount
      newCount
      updateCount
      deleteCount
      enableCount
      disableCount
      unchangedCount
      resumeKey
    }
    properties {
      propertyId
      propertyName
      starRating
      defaultCurrencyCode
      maxRoomsBookable
      numberOfRooms
      numberOfFloors
      address {
        line1
        line2
        city
        state
        stateCode
        postalCode
        country
        countryCode
      }
      contact {
        phone
        fax
        email
        website
      }
      location {
        latitude
        longitude
      }
      currencies {
        code
        name
      }
      languages {
        code
        name
      }
      mappingProviders {
        mappingProvider
        mappingCode
      }
      checkInPolicy
      checkInTime
      checkOutTime
      timeZone
      longDescription
      shortDescription
      adultAge
      defaultLanguage
      adultOnly
    }
  }
}

Response Example

{
    "data": {
        "GetPropertyData": {
            "meta": {
                "dataLoadType": "FULL",
                "timestamp": "2026-08-19T12:44:44Z",
                "totalCount": 1,
                "newCount": 0,
                "updateCount": 1,
                "deleteCount": 0,
                "enableCount": 0,
                "disableCount": 0,
                "unchangedCount": 0,
                "resumeKey": null
            },
            "properties": [
                {
                    "propertyId": 126913,
                    "propertyName": "THE NEW YORKER HOTEL BY LOTTE HOTELS",
                    "starRating": 4.0,
                    "defaultCurrencyCode": "USD",
                    "maxRoomsBookable": null,
                    "numberOfRooms": 1050,
                    "numberOfFloors": 40,
                    "address": {
                        "line1": "481 8th Avenue & 34th Street",
                        "line2": "",
                        "city": "New York",
                        "state": "New York",
                        "stateCode": "NY",
                        "postalCode": "10001",
                        "country": "US",
                        "countryCode": "US"
                    },
                    "contact": {
                        "phone": "1-212-971-0101",
                        "fax": "--",
                        "email": null,
                        "website": "www.newyorkerhotel.com"
                    },
                    "location": {
                        "latitude": "40.75219",
                        "longitude": "-73.99346400000002"
                    },
                    "currencies": [
                        {
                            "code": "USD",
                            "name": "US Dollar"
                        }
                    ],
                    "languages": [
                        {
                            "code": "en",
                            "name": "English"
                        }
                    ],
                    "mappingProviders": [
                        {
                            "mappingProvider": "Vervotech",
                            "mappingCode": "39519752"
                        }
                    ],
                    "checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.",
                    "checkInTime": "16:00",
                    "checkOutTime": "12:00",
                    "timeZone": "America/New_York",
                    "longDescription": "Immerse yourself in the history of NYC at our full-service business hotel in Midtown Manhattan. Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair. Designed with the business traveler in mind, our hotel offers thoughtful amenities and comfortable rooms - ideal for work, play and relaxation.",
                    "shortDescription": "Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair.",
                    "adultAge": 21,
                    "defaultLanguage": "en",
                    "adultOnly": false
                }
            ]
        }
    }
}

Query Parameters

GetPropertyData Variables

Variable	Type	Required	Description
since	DateTime	No	Returns hotels updated after the specified UTC timestamp.
propertyIds	Long	No	Returns specific hotel(s).
countryCode	String	No	Returns hotels based in requested countries. Note: Please talk to your TAM representative at Hotel Trader to enable this. To get list of city, stateCode and countryCode please check respective endpoints.
countryCode + stateCode	String, String	No	Returns hotels based in requested state + country. Cannot be used with state alone. Note: Please talk to your TAM representative at Hotel Trader to enable this. To get list of city, stateCode and countryCode please check respective endpoints.
cityId	Int	No	Returns hotels based in requested city. To get list of city, stateCode and countryCode please check respective endpoints.
limit	Int	Yes	Maximum number of hotels returned in a single response page.
resumeKey	String	No	Pagination token returned from the previous response.
updateTypes	[String]	No	Filters results by update type.

Update Types

UpdateTypes filter is coming soon! Supported values for updateTypes may include:

Value	Description
NEW	Newly created hotel records
UPDATED	Existing hotels with updated content
DELETED	Hotels removed from inventory
ENABLED	Hotels re-enabled for distribution
DISABLED	Hotels disabled from distribution

Pagination

The API uses cursor-based pagination via resumeKey.

First Request

For the initial request:

"resumeKey":null

Next Page Request

Use the resumeKey returned in the previous response:

"resumeKey":"Mjk1OjI="

If no resumeKey is returned, there are no more pages available.

Request Example

Query Variables

{
  "propertyIds": [126913],
  "limit": 1
}

Request

query GetPropertyData($propertyIds: [Long]) {
  GetPropertyData(propertyIds: $propertyIds) {
    meta {
      dataLoadType
      timestamp
      totalCount
      newCount
      updateCount
      deleteCount
      enableCount
      disableCount
      unchangedCount
      resumeKey
    }
    properties {
      propertyId
      propertyName
      starRating
      defaultCurrencyCode
      maxRoomsBookable
      numberOfRooms
      numberOfFloors
      address {
        line1
        line2
        city
        state
        stateCode
        postalCode
        country
        countryCode
      }
      contact {
        phone
        fax
        email
        website
      }
      location {
        latitude
        longitude
      }
      currencies {
        code
        name
      }
      languages {
        code
        name
      }
      mappingProviders {
        mappingProvider
        mappingCode
      }
      checkInPolicy
      checkInTime
      checkOutTime
      timeZone
      longDescription
      shortDescription
      adultAge
      defaultLanguage
      adultOnly
    }
  }
}

Response Example

{
    "data": {
        "GetPropertyData": {
            "meta": {
                "dataLoadType": "FULL",
                "timestamp": "2026-08-19T12:44:44Z",
                "totalCount": 1,
                "newCount": 0,
                "updateCount": 1,
                "deleteCount": 0,
                "enableCount": 0,
                "disableCount": 0,
                "unchangedCount": 0,
                "resumeKey": null
            },
            "properties": [
                {
                    "propertyId": 126913,
                    "propertyName": "THE NEW YORKER HOTEL BY LOTTE HOTELS",
                    "starRating": 4.0,
                    "defaultCurrencyCode": "USD",
                    "maxRoomsBookable": null,
                    "numberOfRooms": 1050,
                    "numberOfFloors": 40,
                    "address": {
                        "line1": "481 8th Avenue & 34th Street",
                        "line2": "",
                        "city": "New York",
                        "state": "New York",
                        "stateCode": "NY",
                        "postalCode": "10001",
                        "country": "US",
                        "countryCode": "US"
                    },
                    "contact": {
                        "phone": "1-212-971-0101",
                        "fax": "--",
                        "email": null,
                        "website": "www.newyorkerhotel.com"
                    },
                    "location": {
                        "latitude": "40.75219",
                        "longitude": "-73.99346400000002"
                    },
                    "currencies": [
                        {
                            "code": "USD",
                            "name": "US Dollar"
                        }
                    ],
                    "languages": [
                        {
                            "code": "en",
                            "name": "English"
                        }
                    ],
                    "mappingProviders": [
                        {
                            "mappingProvider": "Vervotech",
                            "mappingCode": "39519752"
                        }
                    ],
                    "checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.",
                    "checkInTime": "16:00",
                    "checkOutTime": "12:00",
                    "timeZone": "America/New_York",
                    "longDescription": "Immerse yourself in the history of NYC at our full-service business hotel in Midtown Manhattan. Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair. Designed with the business traveler in mind, our hotel offers thoughtful amenities and comfortable rooms - ideal for work, play and relaxation.",
                    "shortDescription": "Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair.",
                    "adultAge": 21,
                    "defaultLanguage": "en",
                    "adultOnly": false
                }
            ]
        }
    }
}

Response Metadata (`meta`)

Field	Type	Description
dataLoadType	String	Type of load returned (`FULL` or `INCREMENTAL`).
timestamp	DateTime	UTC timestamp when the response was generated.
totalCount	Int	Total number of hotel records in the response.
newCount	Int	Number of newly added hotels.
updateCount	Int	Number of updated hotels.
deleteCount	Int	Number of deleted hotels.
enableCount	Int	Number of enabled hotels.
disableCount	Int	Number of disabled hotels.
unchangedCount	Int	Number of unchanged hotels.
resumeKey	String	Pagination token for retrieving the next page.

Hotel Object

Basic Information

Field	Type	Description
propertyId	Long	Unique Hotel Trader property identifier.
propertyName	String	Hotel name.
starRating	Float	Hotel star rating.
defaultCurrencyCode	String	Default currency used by the property.
maxRoomsBookable	Int	Maximum rooms allowed per booking.
numberOfRooms	Int	Total number of rooms in the hotel.
numberOfFloors	Int	Total number of floors in the hotel.

Address Object

Field	Type	Description
line1	String	Primary street address.
line2	String	Secondary address line.
cityId	Int	cityId from geoData.
city	String	City name.
state	String	State or province name.
stateCode	String	State or province code.
postalCode	String	ZIP or postal code.
country	String	Country code or country name.
countryCode	String	ISO country code.

Contact Object

Field	Type	Description
phone	String	Hotel contact phone number.
fax	String	Hotel fax number.
email	String	Hotel contact email address.
website	String	Hotel website URL.

Location Object

Field	Type	Description
latitude	Decimal	Hotel latitude coordinate.
longitude	Decimal	Hotel longitude coordinate.

Currency Object

Field	Type	Description
code	String	ISO currency code.
name	String	Currency display name.

Language Object

Field	Type	Description
code	String	ISO language code.
name	String	Language display name.

Mapping Providers[]

Field	Type	Description
mappingProvider	String	Mapping provider name (e.g. GIATA, Vervotech, TravelBuyer). Contact your TAM representative at Hotel Trader to inform them which ID you would like to receive. In case you would like to receive your own IDs you will have to provide us your entire portfolio along with its metadata in a specific CSV file format.
mappingCode	String	Provider-specific hotel mapping identifier.

Policy & Timing Fields

Field	Type	Description
checkInPolicy	String	Check-in rules or deposit requirements.
checkInTime	String	Hotel check-in time.
checkOutTime	String	Hotel check-out time.
timeZone	String	Hotel local timezone.

Description Fields

Field	Type	Description
longDescription	String	Full hotel description.
shortDescription	String	Shortened hotel description.

Guest Policy Fields

Field	Type	Description
adultAge	Int	Minimum age considered an adult by the property.
defaultLanguage	String	Default hotel content language.
adultOnly	Boolean	Indicates whether the property is adults-only.

GetPropertyData

Request Example

Query Variables

Request

Response Example

GetPropertyData Variables

Update Types

Pagination

First Request

Next Page Request

Request Example

Query Variables

Request

Response Example

Response Metadata (meta)

Hotel Object

Basic Information

Address Object

Contact Object

Location Object

Currency Object

Language Object

Mapping Providers[]

Policy & Timing Fields

Description Fields

Guest Policy Fields

Related Articles

Response Metadata (`meta`)