Advanced Pricing Insights

The Distribusion API has the ability to offer advanced pricing insights to your customers to keep them highly informed of all things related to the cost of their trip.

The advanced pricing insights are a set of features designed to enrich the customer's travel booking journey with valuable pricing information. These features are meant to be integrated into various stages of the online retail process, appearing on pages like search results (price calendar) and booking confirmation page (price hints and price forecast).

Pricing Calendar

The price calendar feature allows end user to easily select departure & return dates of interest by showing minimum price per date, that can be shown in the form of calendar, for example:

It is proposed to be integrated as a support endpoints for search step, and to be called before calling /connections/find when both origin and destination is already known.

There are 2 endpoints:

• /price-insights/calendar – used for one-way search (A→B), returns minimum price calendar for given dates and locations with ability to inclusively filter carriers.
• /price-insights/calendar/return – used for return search (A→B→A), returns minimum 2 way price calendar for given dates and locations and selected departure date with ability to inclusively filter carriers.

Sample Request to /price-insights/calendar

https://api.distribusion.com/retailers/v4/price-insights/calendar?currency=EUR&departure_city=FRNTE&arrival_city=FRLYS&departure_date_start=2025-11-15&departure_date_end=2025-11-18&retailer_partner_number=222222

Sample Response from /price-insights/calendar

{
    "calendar": [
        {
            "date": "2025-11-15",
            "price": 2448
        },
        {
            "date": "2025-11-16",
            "price": 3748
        },
        {
            "date": "2025-11-17",
            "price": 2448
        },
        {
            "date": "2025-11-18",
            "price": 2248
        }
    ]
}

The response will include all dates from departure_date_start until departure_date_end inclusively when either price is present or when corresponding OD found. If the OD is not found, no prices are returned. If the OD is found, all available prices are returned – missing prices will be null.

Sample Request to /price-insights/calendar/return

https://api.distribusion.com/retailers/v4/price-insights/calendar/return?currency=EUR&departure_city=FRNTE&arrival_city=FRLYS&departure_date=2025-11-15&return_date_start=2025-11-15&return_date_end=2025-11-18&retailer_partner_number=222222

Sample Response from /price-insights/calendar/return

{
    "calendar": [
        {
            "date": "2025-11-15",
            "price": 5646
        },
        {
            "date": "2025-11-16",
            "price": 5846
        },
        {
            "date": "2025-11-17",
            "price": 4896
        },
        {
            "date": "2025-11-18",
            "price": 4696
        }
    ]
}

Note that here price shown is total price with return (i.e. A→B + B→A). When asking for return price you don’t need to swap departure and arrival – it is done by service itself. E.g. you got London → Paris calendar and now want to get return calendar: you still pass London as departure and Paris as arrival.

The response must include all dates from return_date_start until return_date_end inclusively when either price is present or when corresponding OD found. If the OD is not found, no prices are returned. If the OD is found, all available prices are returned – missing prices will be null.

It takes into account open return prices whenever possible.

Pricing Hints

Price hints allow end users to easily be aware how the currently selected trip price looks compared to regular price for this trip, example:

It is proposed to integrate the endpoint /price-insights/price-hints at the confirmation step, so this endpoint call should happen in parallel to /connections/vacancy endpoint.

Sample Request to /price-insights/price-hints

https://api.distribusion.com/retailers/v4/price-insights/price-hints?currency=EUR&departure_station=FRPARPRB&arrival_station=FRNTENAN&departure_time=2025-11-05T09:57

Sample Response from /price-insights/price-hints

{
    "reference_price_threshold": 1948,
    "reference_price": 2098
}

Assuming that the response from /connections/vacancy is 1606 (16.06 EUR), then the /connections/vacancy price is lower than reference_price_threshold : 1606 < 1948.

The difference (i.e. how much lower?) is calculated based on reference_price, i.e. (2098-1606) = 492 which translated to 4.92 EUR lower.

Pricing Forecast

Display to your user predictions in future pricing trends, allowing them to better understand when the price will increase.

It is proposed to integrate the endpoint /price-insights/price-forecast at the confirmation step, so this endpoint call should happen in parallel to /connections/vacancy endpoint.

Sample Request to /price-insights/price-forecast

https://api.distribusion.com/retailers/v4/price-insights/price-forecast?marketing_carrier_code=ACOA&departure_station=GBBFSBEU&arrival_station=IEDUBDFA&departure_time=2025-11-05T09:10&fare_class=FARE-1

Sample Response from /price-insights/price-forecast

{
  "expected_price_increase_in_days" : 3
}