FlightPowers Google Flights MCP

{
  "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\" (the default) and \"price\" both order by price, cheapest first; \"duration\" orders shortest first. Applied across all results."
    },
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "Returns 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 the requested 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. When true, it adds the arrival times, the per-leg stop counts, the raw stop details and every row past 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": null,
      "description": "Only flights at or below this price are returned."
    },
    "max_stops": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum stops per flight. 0 means non-stop only."
    },
    "seat_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "1 economy, 2 premium economy, 3 business, 4 first."
    },
    "passengers": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "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. Left out, it means 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": null,
      "description": "The searches this call may make, up or down. Unset is the normal behaviour: with the caller's own key 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. A lower value spends fewer searches on a wide search; a higher one -- to a hard maximum of 300 -- covers a grid wider than that."
    },
    "use_fallback": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Default: 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": null,
      "description": "Restricts the search to these airline codes, e.g. [\"LY\"]."
    },
    "departure_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Single departure date, \"YYYY-MM-DD\"."
    },
    "arrival_time_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latest arrival hour, 0-23."
    },
    "arrival_time_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Earliest arrival hour, 0-23."
    },
    "departure_date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last date of a departure range."
    },
    "departure_time_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latest departure hour, 0-23."
    },
    "departure_time_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Earliest departure hour, 0-23."
    },
    "departure_date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First date of a departure range."
    },
    "exclude_airline_codes": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Airline codes left out of the results."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "Flight search result",
  "required": [
    "results"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Present when the result carries a statement for the person who asked -- 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 requested sort -- 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 one plain sentence."
        },
        "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. With the caller's own key this is the figure their RapidAPI plan is charged. Absent on a free search."
        },
        "plan_requests_limit": {
          "type": "integer"
        },
        "free_searches_day_cap": {
          "type": "integer",
          "minimum": 0
        },
        "plan_requests_remaining": {
          "type": "integer"
        },
        "free_searches_used_today": {
          "type": "integer",
          "minimum": 0
        },
        "requests_used_by_this_call": {
          "type": "integer",
          "minimum": 0,
          "description": "How many date/destination combinations were searched -- what the answer COVERS."
        },
        "free_searches_remaining_today": {
          "type": "integer",
          "minimum": 0
        }
      },
      "description": "With the caller's own key: what this call cost their RapidAPI plan, and what remains on it. On a free signed-in search (`trial` present): the day's free-search counter instead, and no plan figures -- the search ran on FlightPowers' key and nothing is billed to the user. Present on every response that reached the upstream, including a degraded one.",
      "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 describe the fix."
    },
    "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. A repeat is a new billed request: repeat it at most once, and not when the error says the backend expects a repeat to fail (retry: false). '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 the caller's own RapidAPI key, once connected, 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; a request with fewer dates or nights, or a larger plan, does."
    },
    "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\nCoverage comes from here, not 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 consume 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 cover only part of the 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 the answer's basis is on the record either way.",
      "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. An empty `results` array means 'no flights' only when search_status is 'empty'.",
  "additionalProperties": true
}

{
  "title": "FlightPowers: search one-way flights",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "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": null,
      "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\" (the default) and \"price\" both order by price, cheapest first; \"duration\" orders shortest first. Applied across all results."
    },
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "Returns 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 the requested 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. When true, it adds the arrival times, the per-leg stop counts, the raw stop details and every row past 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": null,
      "description": "Only trips at or below this total price are returned."
    },
    "seat_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "1 economy, 2 premium economy, 3 business, 4 first."
    },
    "passengers": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "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. Left out, it means 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": null,
      "description": "Fixed return date. Mutually exclusive with `nights`."
    },
    "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": null,
      "description": "The searches this call may make, up or down. Unset is the normal behaviour: with the caller's own key 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. A lower value spends fewer searches on a wide search; a higher one -- to a hard maximum of 300 -- covers a grid wider than that."
    },
    "use_fallback": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Default: 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": null,
      "description": "Single outbound date, \"YYYY-MM-DD\"."
    },
    "max_return_stops": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum stops on the return leg."
    },
    "departure_date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last date of an outbound range."
    },
    "departure_date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First date of an outbound range."
    },
    "max_departure_stops": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum stops on the outbound leg."
    },
    "return_airline_codes": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Restricts the return leg to these airlines."
    },
    "returns_per_outbound": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "How many return flights to pair with each outbound flight, 1 to 5 (default 2). Each date/destination combination searched still returns at most 10 trips; at 5 they are picked from up to 50 pairings instead of 20. It adds no requests. Not applied when results come from the fallback source."
    },
    "departure_airline_codes": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Restricts the outbound leg to these airlines."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "Flight search result",
  "required": [
    "results"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Present when the result carries a statement for the person who asked -- 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 requested sort -- 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 one plain sentence."
        },
        "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. With the caller's own key this is the figure their RapidAPI plan is charged. Absent on a free search."
        },
        "plan_requests_limit": {
          "type": "integer"
        },
        "free_searches_day_cap": {
          "type": "integer",
          "minimum": 0
        },
        "plan_requests_remaining": {
          "type": "integer"
        },
        "free_searches_used_today": {
          "type": "integer",
          "minimum": 0
        },
        "requests_used_by_this_call": {
          "type": "integer",
          "minimum": 0,
          "description": "How many date/destination combinations were searched -- what the answer COVERS."
        },
        "free_searches_remaining_today": {
          "type": "integer",
          "minimum": 0
        }
      },
      "description": "With the caller's own key: what this call cost their RapidAPI plan, and what remains on it. On a free signed-in search (`trial` present): the day's free-search counter instead, and no plan figures -- the search ran on FlightPowers' key and nothing is billed to the user. Present on every response that reached the upstream, including a degraded one.",
      "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 describe the fix."
    },
    "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. A repeat is a new billed request: repeat it at most once, and not when the error says the backend expects a repeat to fail (retry: false). '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 the caller's own RapidAPI key, once connected, 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; a request with fewer dates or nights, or a larger plan, does."
    },
    "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\nCoverage comes from here, not 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 consume 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 cover only part of the 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 the answer's basis is on the record either way.",
      "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. An empty `results` array means 'no flights' only when search_status is 'empty'.",
  "additionalProperties": true
}

{
  "title": "FlightPowers: search round-trip flights",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

ui://flightpowers/flights-card.html