Flight Network

ISO 3166-1 alpha-2 country code used as booking market. IMPORTANT: Infer it from the trip ORIGIN (not destination). Examples: Amsterdam/AMS -> NL, Oslo/OSL -> NO. Always uppercase, 2 letters.

Airlines likely to operate this route. You MUST populate this list so the UI can display airline names on each flight card. Include all carriers for the route. Example: [{"code": "FR", "name": "Ryanair"}, {"code": "SK", "name": "SAS"}].

IATA airport and city codes with display names. You MUST populate this so the UI can show readable names in the title, tooltips, and connection points. IMPORTANT: always include the exact origin and destination codes you passed to the search (e.g. if you searched origin='LON', include {"code":"LON","name":"London"}), plus individual airport codes from the flight results. Example: [{"code": "LON", "name": "London"}, {"code": "LHR", "name": "London Heathrow"}, {"code": "NYC", "name": "New York"}, {"code": "JFK", "name": "John F. Kennedy Intl"}].

Passenger specification. Adults only: plain number (e.g. '2') or 'adt:N'. Mixed groups: comma-separated segments where 'adt:N' = N adults, 'chd:AGE' = one child aged AGE (2–17), 'inf:AGE' = one infant aged AGE (0–1). Example: 'adt:2,chd:7,chd:4,inf:1' for 2 adults + child aged 7 + child aged 4 + infant aged 1. If unspecified, default to 1 adult. Limits: maximum 9 travellers total; at least 1 adult required per infant.

Optional list of 2-letter IATA carrier codes to include (e.g. ['LH', 'BA']). Use this if the user asks to include specific airlines like Lufthansa or SAS. When specified, only trips flown in part or in whole by one of these carriers are returned. Filtering is applied API-side before any excludedCarriers client-side filtering.

Cabin class code. Y = Economy (default), S = Premium Economy, C = Business, J = Premium Business, F = First, P = Premium First. If not specified, defaults to Economy. NOTE: Higher cabin classes may return some results at a lower cabin class when certain segments do not offer the requested class.

Outbound date in YYYY-MM-DD format. Validation: Date must be between [Today] and [Today + 360 Days]. On failure: Politely explain the limit and ask for a new date

The 3-letter IATA code for the destination city or airport. IMPORTANT: You MUST resolve user input (e.g., 'London') to its IATA code (e.g., 'LON'). If it is a city with multiple airports, use the city code, not a specific airport code (e.g., Paris -> PAR, not CDG).

Optional list of 2-letter IATA carrier codes to exclude (e.g. ['FR', 'RK']). Use this if the user asks to exclude specific airlines like Ryanair. Filtering is applied client-side after the API response (after any allowedCarriers filtering).

Multi-city / open-jaw itinerary. An array of leg objects, each with origin, destination, and departureDate. When present, overrides the flat origin/destination/departureDate fields. Max 6 legs. Dates must be in chronological order.

Maximum number of flight options to return (1–5)

If true, only direct (non-stop) flights are returned. Defaults to false.

The 3-letter IATA code for the origin city or airport. IMPORTANT: You MUST resolve user input (e.g., 'London') to its IATA code (e.g., 'LON'). If it is a city with multiple airports, use the city code, not a specific airport code (e.g., Paris -> PAR, not CDG).

Optional return date in YYYY-MM-DD format. Validation: Date must be between [Today] and [Today + 360 Days]. On failure: Politely explain the limit and ask for a new date