Hotels API

Preferred hotels

The hotels your microsite promotes, returned as full datasheets. Use them for landing pages and recommended rails, then quote them for prices.

GET/accommodations/preferred/{micrositeId}

Datasheets, not offersSpec

The response holds static content only, in the same shape as a datasheet. Quote the hotels with Quote before you show a price or availability.

Request

Headers

auth-tokenstringrequiredDocs
Any valid token. Static content doesn't need the booking-flow token.
Accept-EncodingstringrequiredDocs
gzip

Path

micrositeIdstringrequired
Your microsite id, from your credentials. In your test account, your test microsite id.

Query

destinationIdstring
A destination code from Destinations, for example MAD.
countryCodestring
A country code, for example ES.
firstinteger
Offset of the first result.
limitinteger
Maximum number of hotels to return.
langLanguage
Content language, for example EN.

All query parameters are optional. Spec

Response

200 OK

hotel[]datasheet[]
The promoted hotels, each a full datasheet. The array is named hotel, not accommodations.
auditDataAuditResponseVO
Includes traceId (one per token: log it) and authToken (redact it before logging).

Behaviour

  • The list is the microsite's preferred, promoted hotels. It suits landing pages and "recommended" rails.
  • Each entry is a full datasheet, so the same rules apply: category is a string, there is no thumbnail, and internalRemark must never reach customers. See Datasheet fields.
  • The sources don't describe how the filters combine or what the default page size is. Test your parameters in your test account before you rely on them. Unverified
  • If you use it for merchandising, a daily refresh is enough. Unverified

Datasheets

Full hotel content for one hotel or up to 100 at a time, including images, facilities, description, ratings and category. Use it for hotel pages, maps and filters, never for prices.

Facilities

The hotel and room facility catalogues, with icon classes, priorities and translated labels. Use them to build amenity filters and your icon mapping.