Search empty legs
search_empty_legsFinds current empty-leg flights by origin and/or destination (city, IATA/ICAO code, country, US state, region or area such as Greek Islands), dates, passengers, budget and aircraft class. Returns up to 20 offers with route, date, aircraft, seats, indicative price, a voidjet link and a pre-filled inquiry link; provider names are not included. When more offers match, refine summarises all matches (frequent destinations, date span, prices). With no match, charter_alternative may contain a regular charter via partner Villiers: NOT an empty leg; it names the partner and states that voidjet receives a fee from the partner.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_empty_legs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Order of results: date (earliest departure first) or price (cheapest first). | date |
| limit | No | Number of offers to return. | |
| locale | No | Language of texts and links in the result: en or de. | en |
| offset | No | Number of offers to skip, for paging. | |
| origin | No | Departure city or IATA/ICAO code (e.g. Nice, NCE), or a country, US state, region or area (e.g. Greece, Florida, Caribbean, Greek Islands). | |
| date_to | No | Latest departure date, at most 120 days after date_from. | |
| date_from | No | Earliest departure date (YYYY-MM-DD), default today. | |
| passengers | No | Number of passengers; only offers with at least this many seats. | |
| destination | No | Arrival city, IATA/ICAO code, country, US state, region or area. | |
| max_price_eur | No | Maximum price in EUR for the whole aircraft. | |
| aircraft_class | No | Only these aircraft classes. Offers without a known aircraft type are excluded. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | ||
| notes | No | ||
| total | Yes | Number of matching offers in total. | |
| notice | No | Fee notice, the same in every search response. Pass it on to the user when you show offers. | voidjet receives a fee from the provider or partner for some offers. This does not affect the order of results. |
| offset | Yes | ||
| refine | No | Only when more offers match than returned: frequent destinations, date span and price range of all matches, to suggest how to narrow. | |
| results | Yes | ||
| data_as_of | Yes | ||
| resolved_to | No | ||
| resolved_from | No | ||
| charter_alternative | No | Only when no empty leg matches: a regular charter via a partner. NOT an empty leg; voidjet receives a fee from the partner. |