Hotel Collections Integration
A collection is a curated group of hotels identified by a collectionCode. This page explains how to show a collection in your app with live prices by combining three APIs.
| API | Purpose |
|---|---|
/api/v3/hotel-collections/{{collectionCode}} | Find which hotels belong to the collection |
/api/v1/hotels/static-content | Fetch the static content for those hotels - Static content by multiple ids |
/api/v1/search | Fetch live availability and prices for those hotels - Search by hotelIds |
Integration Flow
-
Get the hotels in the collection. Call Get hotel by collection code with the
collectionCode. Persist the returnedhotelIds. -
Build the collection page. Pass the
hotel0Idsto Static content by multiple ids in a single call instead of one call per hotel (this API is limited to 1 QPS, so one call per hotel would quickly hit the limit). This does not need dates or occupancy, so you can render the hotel cards (image, name, location, facilities).
-
Add prices. Call Search by hotelIds. The response returns a traceId and the lead rate for each hotel.
You can get in touch with our Volt support team to discuss your use cases in detail. Support email: [email protected].
API Reference - Get Hotel Collection by Collection Code
Updated 16 days ago