Hotels

Chat

Conversational hotel search via the supervisor pipeline.

Send a natural-language message; the supervisor searches, reasons, and replies. Hotels that match the query are returned in hotels[] alongside the assistant message.

Images

Each hotel in hotels[] carries two image fields:

  • hero_image_url — use this as the card thumbnail. The system selects the image that best matches the query intent (e.g. a "hotel with pool" search returns a pool photo, not a generic exterior). Always render this field as the primary hotel image; do not fall back to images[0] — they may differ. null only when the hotel has no images.

  • images[] — ordered gallery, up to 5 images per hotel. Use for a lightbox or carousel. Each entry has a url (fully-qualified CDN URL) and an optional label (e.g. "swimming pool indoor", "room"). Empty list when the hotel has no images.

/v1/hotels/{id} returns the same two fields but with up to 50 gallery images.

post/v1/chat

Request

  • Base URL: https://api.vistalink.com
  • URL: https://api.vistalink.com/v1/chat
  • Auth: HTTP bearer

Request body

guest_idstring uuid nullable

Guest profile ID

session_idstring uuid nullable

Existing session to continue

messagestring required

User message

currencystring nullable
localestring nullable
contextobject nullable

Extra structured context

clarification_idstring nullable

The clarification_id echoed back from a previous response

clarification_option_idstring nullable

The id of the option the user selected (set with clarification_id)

Response

Successful Response

session_idstring uuid required
messagestring required

Assistant reply text

poisobject[]
routesobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.