Flow Overview
The Distribusion API facilitates a fully native search, booking and after-sales flow, consisting of these steps:
- Preparing Metadata: Sets the metadata from stations/areas/cities and carries in advance to support the steps in the flow.
- Searching for Trips: Retrieves the list of available trips for a specific departure/arrival date and time, for selected stations/areas/cities, for a defined number of passengers and other search criteria you define.
- Checking Price & Vacancy: Confirms if the trip selected has vacancy and if the price is still the same as in the previous step.
- Creating Reservation: Creates a reservation while the user completes the checkout process.
- Confirming Reservation: Sends a request to confirm the reservation with the carrier.
- Checking Reservation Status: Checks the status of the reservation until is is confirmed by the carrier.
- Booking Confirmation: Displays the booking details after the reservation is confirmed.
- Cancel Booking: Requests the cancellation conditions and process a cancellation.
Optionally, you can call Quick Search before step 2 to check whether content exists on a route and show an indicative "from" price. It sits in front of the flow above and does not replace any of these steps.
Important Update for Existing Partners: We have recently upgraded our core booking architecture to the new Offers API flow. While the general sequence of booking a ticket remains the same, the mechanics of the first three steps (/connections/find, /connections/vacancy, and /reservations/create) have been significantly streamlined. For information about our new flow please check the New Offers Flow Explained guide for a step-by-step walkthrough of the changes.
On this page
- Flow Overview