How the funnel works
The funnel runs as a connected sequence of steps:Create a session
Open a session with the search context: dates, guests, and an optional promo code. The API returns a
sessionId that you carry on every later call and that holds the basket and context through the funnel.Search
With the session open, find the hotels, rooms, and extras that match its context. Refine the results with the filter and sort endpoints (location, budget, rating, and amenities) as the guest narrows their choice.
Describe
For everything the guest sees, pull the descriptions of the rates, rooms, and hotels: text, pictures, amenities, and policies. These change rarely, so cache them to keep the interface fast.
Build a basket
When the guest settles on an offer, add the room and any extras to the basket. It holds their selection until you quote it.
Quote
Quote the basket for its current price and conditions, and fetch the sales terms to display to the guest. When the guest accepts the quote, the Accept a quote response returns a
redirectionUrl to the payment page.Payment
Once the guest is on that page, they enter their card and pay. Payment is hosted and handled by D-EDGE, so you never touch card details.
Get started
Quick start
Create your first session and run your first call in a few minutes.
Reference
Every endpoint, grouped by stage of the funnel.
Best practices
Patterns to build the funnel responsibly and run reliably at scale.
Use cases
Six patterns, from conversational agents to branded confirmation pages.