Filter examples

Direct flights, refundable fares, checked bags, price caps, market hints, airline include/exclude/preference, and flexible dates.

All filters are optional and can be combined when their semantics do not conflict.

Filter reference

Field	Type	Meaning
`direct` / `nonstop`	boolean	Non-stop offers only
`refundable`	boolean	Refundable fares only when supported
`checked_bags`	boolean	Offers including checked baggage
`max_price`	number	Maximum total in the agency currency
`included_airlines`	string[]	Strict allow-list of IATA carrier codes
`excluded_airlines`	string[]	Strict block-list of IATA carrier codes
`preferred_airlines`	string[]	Ranking preference; does not strictly exclude others
`from_cc`	string	Origin market country code
`to_cc`	string	Destination market country code
`flexible`	boolean	Request flexible-date matrix from capable suppliers while keeping regular offers

Do not send included_airlines and excluded_airlines together for the same search. Choose a whitelist or a blacklist. Amadeus rejects supplier requests that contain both.

Refundable only

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "refundable": true
}

Checked baggage only

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "return_date": "2026-09-22",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "checked_bags": true
}

Price cap, market hints, preferred airlines

max_price uses the agency currency. from_cc/to_cc help select the most suitable supplier offices. preferred_airlines influences ranking without acting as a strict whitelist.

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "max_price": 50000,
  "from_cc": "DZ",
  "to_cc": "FR",
  "preferred_airlines": ["AF", "AH"]
}

Include airlines (strict allow-list)

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "included_airlines": ["AF", "AH"]
}

For Amadeus, FX-Port sends a native include filter. Duffel's offer request does not expose a native carrier include field, so FX-Port filters returned offers while preserving the unified response.

Exclude airlines (strict block-list)

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "excluded_airlines": ["TK"]
}

Flexible dates across all suppliers

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "return_date": "2026-09-22",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "flexible": true
}

All compatible suppliers may return regular offers; only suppliers with flexible-date support add a flexPrices matrix. Always check for matrix presence. Use the dedicated flexible_search endpoint when you want only flexible-capable suppliers.