Search offers

Your API key from the dashboard. A missing or invalid key answers 401; see Authentication.

Age 12+, at least 1. Adults, children and infants total at most 9 (400 too_many_passengers); your agency may set a lower cap (400 passenger_cap).

economy, premium_economy, business or first; anything else is 400 invalid_search.

Age 2–11.

ISO 4217 code: EUR, GBP, USD, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, CAD, AUD, NZD, JPY, SGD, HKD, AED or MAD. The airline may still quote in its own currency: read currency on each offer.

Outbound date, from yesterday to 361 days ahead (UTC); outside it 400 date_out_of_range. Not needed with legs.

IATA airport code. Must differ from origin (400 same_airport). Not needed with legs.

Lap infants under 2; no more than adults (400 infants_exceed_adults).

Multi-city: 2–5 bounds of {origin, destination, departure_date}, in date order (400 invalid_date otherwise). Replaces origin, destination, departure_date and return_date.

Absent: any. 0: non-stop only. 1–5: up to that many connections.

IATA airport code (3 letters). Not needed with legs.

Makes the search a round trip. On or after departure_date (400 return_before_departure).

Also return self-transfer trips: two connected airlines on separate tickets (offers with self_transfer: true). One-way and round trips only; ignored with legs or max_stops: 0. Not available yet: accepted and ignored.

Until when this answer is reused for the same search: the earliest offer's expires_at less five minutes, between 90 s and 30 min.

total, airlines[], sources[] and min_price of the returned offers.

The offers, cheapest first. null when no airline returned any.

IATA airline code, e.g. AA.

The airline's own offer ID, unchanged.

Bag allowances and extras listed with the fare: type (e.g. bag_checked, bag_carry_on), name, included_in_fare, and for bags weight_kg and dimensions_cm (length + width + height). A bag that is not included still shows its limits.

Whether a checked bag is in the fare.

The airline's base fare, all passengers.

Main cabin of the itinerary.

ISO 4217 code of every amount on the offer.

After it the offer cannot be priced or booked.

Branded fare: id, name, brand_id, description and benefits[]. Each benefit has type (carry_on, checked_bag, seat_selection, changes, refund, lounge, priority_boarding, miles_accrual, meal, wifi, fast_track or other), included, description and optional value (e.g. 23kg). For other, show the description.

refundable and changeable (null when the airline does not say); penalties refund_penalty_amount/_currency/_type and change_penalty_amount/_currency/_type (type fixed, percentage or none); optional change_allowed_before_departure, change_allowed_after_departure, min_stay, max_stay, advance_purchase_required, advance_purchase_days, raw_text. restrictions[] lists each statement as the airline made it: action (refund or change), stage (before_departure, after_departure or absent), allowed, fee, percent, currency. The headline fields summarise the before-departure stage, or the only stage stated.

Offer ID. Opaque; it can contain | and ., so percent-encode it in a URL path.

The airline offer behind each ticket (offer_id, airline), in flying order, for reference. Price and book the trip by its own offer_id.

Per passenger type: type (ADT, CHD, INF), count, and per-passenger base_fare, taxes, total (before service_fee).

0.0–1.0 completeness of the offer's data. See quality scores.

A trip on separate tickets from two airlines (only when the search sent self_transfer). The traveller re-checks bags and no airline protects the connection: show this before purchase.

Your commission (Dashboard → Commissions), included in total_amount. Absent when no rule applies.

One per direction or multi-city bound: id, origin, destination, departure_utc, arrival_utc, duration_minutes (layovers included), stops, segments[].

Flights: segment_id, origin, destination, departure_utc, arrival_utc, duration_minutes, flight_number, marketing_carrier, operating_carrier, aircraft, departure_terminal, arrival_terminal, cabin_class, booking_class, fare_basis, optional meal_service.

ndc_direct, gds_fallback or lcc_direct.

NDC (New Distribution Capability) schema version behind the offer, e.g. NDC-21.3.

The airline's taxes and fees, all passengers.

Total for all passengers: base_fare + taxes_fees + service_fee.

total_amount as {amount, currency}.

Each change of a self-transfer trip: airport, arrival_utc, departure_utc, layover_minutes (180–1440), overnight, from_airline, to_airline, recheck_baggage (always true).

Id of this search (srch_…).