Hotels - Content

Hotel content and catalog endpoints

📄️ Get list of hotels

Retrieves a paginated list of hotels based on search query.

📄️ Get hotels by base codes

Returns hotel content for a list of Bundleport base codes (mapping_hotels.base_code).

📄️ Filter hotel codes

Returns hotel codes matching filter criteria. Optimized for pre-filtering before availability searches.

📄️ Get hotels by provider-native codes

Returns full hotel content for provider-native hotel IDs (the provider's own property id).

📄️ Translate hotel codes across providers

Resolves provider-native hotel IDs to Bundleport base codes and, when requested, to other providers' native IDs. Omit targetProviders (or send []) for source-to-base only. Unknown target providers are omitted from each result rather than treated as errors. Codes beyond maxSize (default 100, max 1000) are truncated.

📄️ Get hotels whose content changed since an instant

Incremental content feed. Returns the same merged payload as `by-base-codes`, restricted to

📄️ Search hotels (lightweight catalog)

Returns a minimal list of hotels for UI search (base code, provider code, name, facets, city).

📄️ Hotel name typeahead (cross-provider, ranked)

Cross-provider hotel name autocomplete ranked by trigram similarity (prefix matches first).

📄️ Search hotel chains (typeahead catalog over provider_chains)

Typeahead search over the provider_chains catalog (one row per (providerCode, chainCode)).

📄️ List Bundleport-level master chains

Returns the canonical Bundleport-level chain view. Each master groups one or more

📄️ Get one master chain by ID

Returns the canonical Bundleport-level chain and its members

📄️ List hotels of a master chain (direct + transitive via base_code)

Returns the hotels that belong to the master chain identified by `id`,

📄️ Get hotels by destination (canonical city)

Returns hotels whose `canonical_city_id` is in the catchment of

📄️ Get hotels by coordinates (point + radius)

Returns hotels within a radius (km) of a point, ordered by distance. Same response shape as by-destination,

📄️ Get list of destinations

Retrieves a paginated list of destinations based on search query

📄️ Get list of boards

Retrieves a list of boards (meal plans) based on search query

📄️ Get list of categories

Retrieves a list of categories based on search query

📄️ Get list of rooms

Retrieves a paginated list of rooms. The request must be scoped: `query` is mandatory and has to carry at least one of `connectionCode`, `providerCode`, `roomCodes` or `hotelCodes`. An unscoped or unwrapped body is rejected with 400 rather than served as an arbitrary page of the whole multi-provider catalog.

📄️ Get metadata

Retrieves provider metadata based on search query

📄️ Base code fragmentation counters

Reports how many groups of base codes still describe the same physical hotel and how

📄️ Retired base codes and their survivors

Lists base codes retired by a consolidation together with the code that replaced them.

📄️ Canonical amenity dictionary

Publishes the canonical amenity codes behind the normalized `amenities` returned on

📄️ Canonical room type codes

Publishes distinct room `baseCode` values from `mapping_rooms` with optional usage

📄️ Provider hotel codes for a base code

Returns all provider hotel codes mapped to a Bundleport base code, each with the

📄️ Room provider codes for a base code

Returns room mappings (provider room code → bundleportRoomCode) for all provider