HotelsSearchRequest

Flat search body. Scope: at least one of destination (canonical city UUID) or countryCode. providerCode is required (lowercase in DB).

destinationstring

Canonical city place UUID (same as filters.canonicalCityId on /hotels/filter).

Example: 2490e7e5-5cf4-474e-8ada-5c70781be6fc

countryCodestring

ISO-3166-1 alpha-2 country code (hotels.canonical_country_code).

Example: ES

hotelNamestring

Case-insensitive partial match (max 200 characters).

providerCodestring

Provider code (required).

Example: example

categorystring

Single category / star code (e.g. 4STAR or numeric 4 → 4STAR).

propertyTypestring

Exact match on hotels.property_type.

chainCodestring

Exact match on hotels.chain_code.

limitinteger

Possible values: >= 1 and <= 500

Default value: 20

offsetinteger

Possible values: >= 0 and <= 5000

Default value: 0

viewstring

Only "basic" is supported.

Possible values: [basic]

Default value: basic

cursorstring

Keyset pagination — return rows with provider hotel code greater than this value (same provider).

HotelsSearchRequest

{
  "destination": "2490e7e5-5cf4-474e-8ada-5c70781be6fc",
  "countryCode": "ES",
  "hotelName": "string",
  "providerCode": "example",
  "category": "string",
  "propertyType": "string",
  "chainCode": "string",
  "limit": 20,
  "offset": 0,
  "view": "basic",
  "cursor": "string"
}