Unified flight shop endpoint. When offer_token is present the handler re-prices that offer (price-check mode); otherwise it performs a live search by route with optional JIN-187 filter fields (cabin_class, direct_only, max_price, include_carriers, exclude_carriers).
Shop flight request
economy, premium_economy, business, first
default USD
YYYY-MM-DD
3-letter IATA city or airport code
"city" (default) or "airport"
ExcludeCarriers is a list of IATA 2-letter marketing codes to blacklist. Internally populates the connector's BlackListCarriers.MarketingCarriers.
Format selects the response shape. Defaults to "text" (LLM-friendly human-readable strings). Set to "structured" to receive the canonical flight.FlightCheckResponse with Amount objects (for client-side formatters / widgets).
text, structured JIN-187 filter additions. All forwarded to the connector when present. IncludeCarriers is a list of IATA 2-letter marketing codes to whitelist.
default en
Mode B: Price-check by offer token
Mode A: Search by params
"city" (default) or "airport"
Shared
YYYY-MM-DD
"oneway" or "roundtrip", default "roundtrip"
OK
human-readable explanation when status != confirmed
"search" or "price_check"
e.g. "USD 12.50" or "USD -8.00"
Price-check metadata (only in price_check mode when status=confirmed)
original cached price the user saw
"confirmed" or "flight_unavailable" (price_check mode only)