AirShopping
POST
https://polarhub-tsdv001.sandbox.halo-platform.net/hub/polarpie/v2/airShopping
PolarHub API
Last modified:2026-05-18 02:46:21
Overview
as fares, baggage allowance, and fare rules.
Endpoints
AirShopping operation is exposed through two paths. Both accept an identical request schema and return the same response shape — choose either based on your integration preference.| Endpoint | Path | When to use |
|---|---|---|
| Default | POST /hub/polarpie/v2/airShopping | Standard AirShopping. Returns the offer set as received from carrier responses. |
| AirShoppingPlus | POST /exp/polarhub/v2/airshopping | Same NDC contract with response-side enhancements applied by PolarHub before delivery: performance optimizations, weighted offer ranking, |
| and upcoming intelligence-driven features. |
Usage Guidelines
Passenger
Trip type
Airlines selection
Direct flight only
Schedule
Fare
FFN (Loyalty program)
MatchResult
AirShoppingRS/Offer/MatchResultAugmentationPoint (Fare Combinability Hints)
MatchResult = Partial, some carriers (e.g., LH, EK) returnper-leg offers that must follow a combinability rule when priced as a
round-trip in OfferPrice. PolarHub passes through the carrier's
combinability hints in the
AugmentationPoint element of the AirShoppingresponse. Tenants should reference these hints to build valid offer
combinations and avoid pricing errors at the OfferPrice step.
PriceClass — combination by PriceClass reference IDsFareBasisCode — combination by FareBasis codes{
"AugPoint": {
"Owner": "LH",
"Association": {
"PriceClassRefID": ["Xpc09003ad0a7c35"]
},
"Combinability": {
"Association": [
{
"Type": "PriceClass",
"ReferenceValue": [
"Xpc09003ad0a7c35",
"Xpc13003ad0a7c35",
"Xpc1c003ad0a7c35"
]
}
]
}
}
}{
"AugPoint": {
"Owner": "EK",
"Association": {
"FareBasisCode": ["KXEESKR1"]
},
"Combinability": {
"Association": [
{
"Type": "FareBasisCode",
"ReferenceValue": [
"LXEEPKR1",
"KXEESKR1",
"XXRZFKR1",
"EXPZFKR1"
]
}
]
}
}
}:highlight gray 📌 AugPointis provided as-is from the carrier and is
pass-through only — PolarHub does not filter or enrich it. Use the
referenced PriceClass IDs or FareBasis codes to determine which offers
can be combined when calling OfferPrice.
Offer Curation (AirShoppingPlus only)
What it does
Importance signals used in ranking
| Signal | What it captures |
|---|---|
| Price | Total offer price relative to the cheapest and most expensive offers in the same response. Lower price → higher score. |
| Baggage allowance | Free checked-baggage entitlement (weight in kg and/or piece count) compared to the rest of the response. More generous allowance → higher score. |
| Airline preference | Carrier-level preference defined in the importance profile. |
| Cabin | Match between the requested cabin (Y / W / C / F) and the cabin actually offered on each leg. |
| Departure / arrival time | Alignment with traveller-friendly time bands defined in the importance profile. |
| Direct vs connecting | Number of segments per journey. Direct flights score higher than connecting itineraries. |
The importance profile is managed centrally by PolarHub and applied
uniformly to every AirShoppingPlus request. Profile weights are tuned by
PolarHub based on aggregate booking behaviour and may be updated over time
without an integration change.
How offers are selected
1.
2.
3.
What you gain
Notes
POST /exp/polarhub/v2/airshopping.The Default endpoint at
POST /hub/polarpie/v2/airShopping returns the full, uncurated offer set.Request
Header Params
Body Params application/json
Request Code Samples
Responses
Modified at 2026-05-18 02:46:21