Google Flights Search (Real-Time Fares)

{'type': 'object', 'required': ['from_airport', 'to_airport'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'description': 'Maximum flights to return, after merging and sorting.'}, 'sort_by': {'type': 'string', 'default': 'best', 'description': '"best", "price", or "duration". Applied across all results.'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Return every field the upstream sends on each fare, and every fare that was selected, with no row bound. Off by default: a result carries the best rows by your sort_by in a compact shape (dates, destination, airline, stops, duration, price, trip length and the booking link), because a wide search over a month and several destinations otherwise produces a megabyte of JSON that some hosts refuse to put in the conversation at all. Turn it on when you need the arrival times, the per-leg stop counts, the raw stop details or more rows than results_returned; results_total always says how many there were.'}, 'currency': {'type': 'string', 'default': 'usd', 'description': 'ISO currency code, default "usd".'}, 'max_price': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Only return flights at or below this price.'}, 'max_stops': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum stops per flight. 0 means non-stop only.'}, 'seat_type': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': '1 economy, 2 premium economy, 3 business, 4 first.'}, 'passengers': {'anyOf': [{'type': 'array', 'items': {'type': 'integer'}}, {'type': 'null'}], 'default': None, 'description': 'One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult. A counts list [adults, children, infants], e.g. [2, 1, 0], or a bare [2] for two adults, is recognised and converted to codes before the search; a list that is valid as codes is searched as codes.'}, 'to_airport': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Destination airport. One IATA code ("BCN"), several separated by commas ("BCN,LIS,ATH"), or a list (["BCN","LIS","ATH"]) -- every shape is accepted and the destinations are compared in the same search.'}, 'from_airport': {'type': 'string', 'description': 'Origin IATA code, e.g. "TLV". One origin per search; a second one is refused rather than searched.'}, 'max_searches': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': "The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths is 93 combinations and a whole month x 3 nights x 3 destinations is 279; both run in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 300 -- for a grid wider than that."}, 'use_fallback': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': "Leave unset. Switches the search to a second, independent flight data source instead of the usual Google Flights page read. Unset already escalates to that source once, automatically, after a search's retries have failed. true forces it inline on every attempt -- much slower, and it can time out. false disables it entirely, that automatic retry included."}, 'airline_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Restrict to these airline codes, e.g. ["LY"].'}, 'departure_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Single departure date, "YYYY-MM-DD".'}, 'arrival_time_max': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Latest arrival hour, 0-23.'}, 'arrival_time_min': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Earliest arrival hour, 0-23.'}, 'departure_date_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Last date of a departure range.'}, 'departure_time_max': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Latest departure hour, 0-23.'}, 'departure_time_min': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Earliest departure hour, 0-23.'}, 'departure_date_from': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'First date of a departure range.'}, 'exclude_airline_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Exclude these airline codes.'}}, 'additionalProperties': False}

{'type': 'object', 'title': 'Flight search result', 'required': ['results'], 'properties': {'message': {'type': 'string', 'description': 'Present when there is something the model must relay to the user rather than silently absorb -- no results, a degraded search, a missing key or a spent quota.'}, 'partial': {'type': 'string', 'description': 'Present when some searches failed but others succeeded. Plain text saying how much of the request the results cover.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': "The fares found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.\n\nThis is the TOP results_returned of results_total rows by the sort you asked for -- cheapest first by default, shortest first on sort_by 'duration' -- with every destination that has fares still represented. Each row is in a compact shape: destination, the date or dates, trip length in nights on a round trip, airline (both legs on a round trip), stops, duration, the price as a string and a number, Google's price band with its verdict, and the booking link. The origin is on the response as from_airport rather than repeated on every row. Arrival descriptions, per-leg stop counts, raw stop details and the duration in seconds are dropped; `verbose: true` returns them, and every row that was selected, on that call."}, 'api_usage': {'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'The same figures as a sentence, for the model to relay.'}, 'hub_requests_billed': {'type': 'integer', 'minimum': 0, 'description': 'How many HTTP requests RapidAPI actually billed. Larger than requests_used_by_this_call when a search failed with a server error and was retried, because the retry is billed too. This is the figure the invoice will show.'}, 'plan_requests_limit': {'type': 'integer'}, 'plan_requests_remaining': {'type': 'integer'}, 'requests_used_by_this_call': {'type': 'integer', 'minimum': 0, 'description': 'How many date/destination combinations were searched -- what the answer COVERS.'}}, 'description': "What this call cost the caller's own RapidAPI plan, and what remains on it. Present on every response that reached the upstream, including a degraded one -- a search that failed was still billed.", 'additionalProperties': True}, 'signup_url': {'type': 'string', 'description': 'Where the caller subscribes or changes plan.'}, 'from_airport': {'type': 'string', 'description': "The origin, as the upstream renders it ('Tel Aviv (TLV)'). One origin per search, so it is on the response rather than repeated on every row."}, 'result_count': {'type': 'integer', 'minimum': 0, 'description': 'How many rows are in `results`; same as results_returned.'}, 'needs_api_key': {'type': 'boolean', 'description': 'True when no usable RapidAPI key arrived with the call, or the upstream rejected the one that did. No search was run and nothing was billed; signup_url and message say how to fix it.'}, 'results_total': {'type': 'integer', 'minimum': 0, 'description': 'How many fares the search selected across every searched combination, before any row bound. Equal to results_returned unless the server bounded a response it had widened itself.'}, 'search_status': {'enum': ['ok', 'empty', 'partial', 'degraded', 'trial_exhausted', 'quota_exceeded'], 'type': 'string', 'description': "Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help. 'quota_exceeded': the search was refused because the caller's remaining allowance or plan quota cannot cover the number of combinations asked for; combos_requested and combos_allowed_now carry the two numbers. Nothing was searched beyond what it cost to read the quota. Retrying the same search does not help -- ask for fewer dates or nights, or move to a larger plan."}, 'by_destination': {'type': 'object', 'description': "One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `row_count` is how many of this destination's fares were selected; the fares themselves are in `results` and are not repeated here. `verbose: true` restores the `rows` array for callers that read it.", 'additionalProperties': {'type': 'object', 'required': ['row_count', 'searched', 'reason'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': "Only on `verbose: true`: this destination's selected rows, the same objects that are in `results`."}, 'dates': {'type': 'object', 'description': 'Present only on multi-date searches: one entry per departure date requested for this destination, so a date the fan-out cap sampled away is visible rather than absent. `cheapest_price` is null when that date has no row in `results`.', 'additionalProperties': {'type': 'object', 'properties': {'reason': {'enum': ['ok', 'no_flights', 'search_failed', 'not_in_limit', 'not_searched'], 'type': 'string'}, 'searched': {'type': 'boolean'}, 'row_count': {'type': 'integer', 'minimum': 0}, 'cheapest_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': True}}, 'reason': {'enum': ['ok', 'no_flights', 'search_failed', 'not_in_limit', 'not_searched'], 'type': 'string'}, 'cheapest': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'description': "The lowest-priced of this destination's rows in `results`, or null when it has none."}, 'searched': {'type': 'boolean', 'description': 'Whether at least one search actually ran for this destination. False means the fan-out cap dropped it.'}, 'row_count': {'type': 'integer', 'minimum': 0, 'description': "How many of this destination's fares were selected. Not all of them are necessarily in `results`: a wide search returns the top results_returned of results_total overall, and `cheapest` below is this destination's own best fare either way."}}, 'additionalProperties': True}}, 'quota_exhausted': {'type': 'boolean', 'description': "True when the caller's RapidAPI plan has no requests left for the current period."}, 'search_coverage': {'type': 'object', 'properties': {'note': {'type': 'string'}, 'truncated': {'type': 'boolean', 'description': "True when the request expanded past this call's spend ceiling and was sampled. A date absent from departure_dates_searched was never searched, which is not the same as having no flights."}, 'stopped_early': {'type': 'string', 'description': "Present when something other than the cap ended the fan-out. 'deadline': the call reached its time limit and the remaining combinations were never sent or billed, so the results are real but do not cover the whole range."}, 'hub_requests_billed': {'type': 'integer', 'minimum': 0, 'description': 'HTTP requests billed by RapidAPI for this call, retries included; see api_usage.hub_requests_billed.'}, 'destinations_searched': {'type': 'array', 'items': {'type': 'string'}}, 'searched_combinations': {'type': 'integer', 'minimum': 0}, 'requested_combinations': {'type': 'integer', 'minimum': 0}, 'departure_dates_searched': {'type': 'array', 'items': {'type': 'string'}}, 'max_searches_per_request': {'type': 'integer', 'minimum': 1}}, 'description': 'What was actually searched. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.', 'additionalProperties': True}, 'results_returned': {'type': 'integer', 'minimum': 0, 'description': 'How many of them are in `results` -- the best ones by the sort_by asked for, cheapest first by default, and never all of one destination at the expense of another. Lower than results_total only when `limit` was raised by the server to cover the fan-out rather than asked for; search_coverage.note says so when it happens, and `verbose: true` returns them all.'}}, 'description': "A completed flight search. Read search_status before reading results: an empty array means 'no flights' only when search_status is 'empty'.", 'additionalProperties': True}

{'type': 'object', 'required': ['from_airport', 'to_airport'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'description': 'Maximum trips to return, after merging and sorting.'}, 'nights': {'anyOf': [{'type': 'integer'}, {'type': 'array', 'items': {'type': 'integer'}}, {'type': 'null'}], 'default': None, 'description': 'Trip length in nights; a number, or a list like [5, 6, 7]. The return date is derived from each departure date.'}, 'sort_by': {'type': 'string', 'default': 'best', 'description': '"best", "price", or "duration". Applied across all results.'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Return every field the upstream sends on each fare, and every fare that was selected, with no row bound. Off by default: a result carries the best rows by your sort_by in a compact shape (dates, destination, airline, stops, duration, price, trip length and the booking link), because a wide search over a month and several destinations otherwise produces a megabyte of JSON that some hosts refuse to put in the conversation at all. Turn it on when you need the arrival times, the per-leg stop counts, the raw stop details or more rows than results_returned; results_total always says how many there were.'}, 'currency': {'type': 'string', 'default': 'usd', 'description': 'ISO currency code, default "usd".'}, 'max_price': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Only return trips at or below this total price.'}, 'seat_type': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': '1 economy, 2 premium economy, 3 business, 4 first.'}, 'passengers': {'anyOf': [{'type': 'array', 'items': {'type': 'integer'}}, {'type': 'null'}], 'default': None, 'description': 'One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult. A counts list [adults, children, infants], e.g. [2, 1, 0], or a bare [2] for two adults, is recognised and converted to codes before the search; a list that is valid as codes is searched as codes.'}, 'to_airport': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Destination airport. One IATA code ("BCN"), several separated by commas ("BCN,LIS,ATH"), or a list (["BCN","LIS","ATH"]) -- every shape is accepted and the destinations are compared in the same search.'}, 'return_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Fixed return date. Use this OR nights, not both.'}, 'from_airport': {'type': 'string', 'description': 'Origin IATA code, e.g. "TLV". One origin per search; a second one is refused rather than searched.'}, 'max_searches': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': "The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths is 93 combinations and a whole month x 3 nights x 3 destinations is 279; both run in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 300 -- for a grid wider than that."}, 'use_fallback': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': "Leave unset. Switches the search to a second, independent flight data source instead of the usual Google Flights page read. Unset already escalates to that source once, automatically, after a search's retries have failed. true forces it inline on every attempt -- much slower, and it can time out. false disables it entirely, that automatic retry included."}, 'departure_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Single outbound date, "YYYY-MM-DD".'}, 'max_return_stops': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum stops on the return leg.'}, 'departure_date_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Last date of an outbound range.'}, 'departure_date_from': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'First date of an outbound range.'}, 'max_departure_stops': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum stops on the outbound leg.'}, 'return_airline_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Restrict the return leg to these airlines.'}, 'departure_airline_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Restrict the outbound leg to these airlines.'}}, 'additionalProperties': False}

{'type': 'object', 'title': 'Flight search result', 'required': ['results'], 'properties': {'message': {'type': 'string', 'description': 'Present when there is something the model must relay to the user rather than silently absorb -- no results, a degraded search, a missing key or a spent quota.'}, 'partial': {'type': 'string', 'description': 'Present when some searches failed but others succeeded. Plain text saying how much of the request the results cover.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': "The fares found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.\n\nThis is the TOP results_returned of results_total rows by the sort you asked for -- cheapest first by default, shortest first on sort_by 'duration' -- with every destination that has fares still represented. Each row is in a compact shape: destination, the date or dates, trip length in nights on a round trip, airline (both legs on a round trip), stops, duration, the price as a string and a number, Google's price band with its verdict, and the booking link. The origin is on the response as from_airport rather than repeated on every row. Arrival descriptions, per-leg stop counts, raw stop details and the duration in seconds are dropped; `verbose: true` returns them, and every row that was selected, on that call."}, 'api_usage': {'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'The same figures as a sentence, for the model to relay.'}, 'hub_requests_billed': {'type': 'integer', 'minimum': 0, 'description': 'How many HTTP requests RapidAPI actually billed. Larger than requests_used_by_this_call when a search failed with a server error and was retried, because the retry is billed too. This is the figure the invoice will show.'}, 'plan_requests_limit': {'type': 'integer'}, 'plan_requests_remaining': {'type': 'integer'}, 'requests_used_by_this_call': {'type': 'integer', 'minimum': 0, 'description': 'How many date/destination combinations were searched -- what the answer COVERS.'}}, 'description': "What this call cost the caller's own RapidAPI plan, and what remains on it. Present on every response that reached the upstream, including a degraded one -- a search that failed was still billed.", 'additionalProperties': True}, 'signup_url': {'type': 'string', 'description': 'Where the caller subscribes or changes plan.'}, 'from_airport': {'type': 'string', 'description': "The origin, as the upstream renders it ('Tel Aviv (TLV)'). One origin per search, so it is on the response rather than repeated on every row."}, 'result_count': {'type': 'integer', 'minimum': 0, 'description': 'How many rows are in `results`; same as results_returned.'}, 'needs_api_key': {'type': 'boolean', 'description': 'True when no usable RapidAPI key arrived with the call, or the upstream rejected the one that did. No search was run and nothing was billed; signup_url and message say how to fix it.'}, 'results_total': {'type': 'integer', 'minimum': 0, 'description': 'How many fares the search selected across every searched combination, before any row bound. Equal to results_returned unless the server bounded a response it had widened itself.'}, 'search_status': {'enum': ['ok', 'empty', 'partial', 'degraded', 'trial_exhausted', 'quota_exceeded'], 'type': 'string', 'description': "Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help. 'quota_exceeded': the search was refused because the caller's remaining allowance or plan quota cannot cover the number of combinations asked for; combos_requested and combos_allowed_now carry the two numbers. Nothing was searched beyond what it cost to read the quota. Retrying the same search does not help -- ask for fewer dates or nights, or move to a larger plan."}, 'by_destination': {'type': 'object', 'description': "One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `row_count` is how many of this destination's fares were selected; the fares themselves are in `results` and are not repeated here. `verbose: true` restores the `rows` array for callers that read it.", 'additionalProperties': {'type': 'object', 'required': ['row_count', 'searched', 'reason'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': "Only on `verbose: true`: this destination's selected rows, the same objects that are in `results`."}, 'dates': {'type': 'object', 'description': 'Present only on multi-date searches: one entry per departure date requested for this destination, so a date the fan-out cap sampled away is visible rather than absent. `cheapest_price` is null when that date has no row in `results`.', 'additionalProperties': {'type': 'object', 'properties': {'reason': {'enum': ['ok', 'no_flights', 'search_failed', 'not_in_limit', 'not_searched'], 'type': 'string'}, 'searched': {'type': 'boolean'}, 'row_count': {'type': 'integer', 'minimum': 0}, 'cheapest_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': True}}, 'reason': {'enum': ['ok', 'no_flights', 'search_failed', 'not_in_limit', 'not_searched'], 'type': 'string'}, 'cheapest': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'description': "The lowest-priced of this destination's rows in `results`, or null when it has none."}, 'searched': {'type': 'boolean', 'description': 'Whether at least one search actually ran for this destination. False means the fan-out cap dropped it.'}, 'row_count': {'type': 'integer', 'minimum': 0, 'description': "How many of this destination's fares were selected. Not all of them are necessarily in `results`: a wide search returns the top results_returned of results_total overall, and `cheapest` below is this destination's own best fare either way."}}, 'additionalProperties': True}}, 'quota_exhausted': {'type': 'boolean', 'description': "True when the caller's RapidAPI plan has no requests left for the current period."}, 'search_coverage': {'type': 'object', 'properties': {'note': {'type': 'string'}, 'truncated': {'type': 'boolean', 'description': "True when the request expanded past this call's spend ceiling and was sampled. A date absent from departure_dates_searched was never searched, which is not the same as having no flights."}, 'stopped_early': {'type': 'string', 'description': "Present when something other than the cap ended the fan-out. 'deadline': the call reached its time limit and the remaining combinations were never sent or billed, so the results are real but do not cover the whole range."}, 'hub_requests_billed': {'type': 'integer', 'minimum': 0, 'description': 'HTTP requests billed by RapidAPI for this call, retries included; see api_usage.hub_requests_billed.'}, 'destinations_searched': {'type': 'array', 'items': {'type': 'string'}}, 'searched_combinations': {'type': 'integer', 'minimum': 0}, 'requested_combinations': {'type': 'integer', 'minimum': 0}, 'departure_dates_searched': {'type': 'array', 'items': {'type': 'string'}}, 'max_searches_per_request': {'type': 'integer', 'minimum': 1}}, 'description': 'What was actually searched. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.', 'additionalProperties': True}, 'results_returned': {'type': 'integer', 'minimum': 0, 'description': 'How many of them are in `results` -- the best ones by the sort_by asked for, cheapest first by default, and never all of one destination at the expense of another. Lower than results_total only when `limit` was raised by the server to cover the fan-out rather than asked for; search_coverage.note says so when it happens, and `verbose: true` returns them all.'}}, 'description': "A completed flight search. Read search_status before reading results: an empty array means 'no flights' only when search_status is 'empty'.", 'additionalProperties': True}