Hotel Online

Hotel Online API documentation | HyperGuest Store

Hotel Online API documentation for hotel availability search, request parameters and store authentication, powered by HyperGuest Store. This reference describes the API used by this store’s booking website.

Base URL and authentication

Use this store’s origin as the base URL. Public stores use their configured server-side credentials; callers do not provide a HyperGuest API key. Private stores require a signed-in session and an authorized organization and organization token selection. Credentials are managed by the store.

Hotel availability search

GET /api/search
  • checkIn: arrival date in YYYY-MM-DD format.
  • nights: a positive integer number of nights.
  • hotelIds: comma-separated property IDs from the store’s hotel listings.
  • guests: room occupancies separated by dots. For example, 2-5,8.1 means two adults with children aged 5 and 8 in one room, and one adult in another.
  • currency: requested currency code, or PROPERTY for the property currency.
  • nationality: guest nationality country code.
  • organizationId and organizationTokenId: authorized selections for private stores.
  • ratePlans: optional filter, available only when enabled by the store.

A successful response is a JSON array of properties with id and rooms. Rooms include roomCode, ratePlanCode, pax, price, cancellationPolicies, fees and availability. An empty array means there are no matching offers. Prices are returned with their currency.

Invalid nights return HTTP 400. A disabled ratePlans filter returns 403. Private store authentication failures return 401 or 403. Availability results do not reserve a room or confirm a booking.

Destination and property suggestions

GET /api/auto-suggest?query=London

Searches this store’s catalog for destination and property suggestions. The query parameter is required; a missing query returns HTTP 400. The optional type parameter filters suggestions.

Resources

© 2026 Hotel Online

Unterstützt durch HyperGuest

© 2026 Hotel Online
·

Unterstützt durch HyperGuest