Search empty legs
search_empty_legsRead-onlyIdempotent
Find current empty-leg flights. Give at least origin or destination (city name or IATA/ICAO code). Returns up to 20 offers with route, date, aircraft, seats, indicative price and a voidjet link plus a pre-filled inquiry link for the user. Provider names are not included. With no match, charter_alternative may offer a regular charter via partner Villiers: NOT an empty leg and a paid partner offer, tell the user both.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | date | |
| limit | No | ||
| locale | No | en | |
| offset | No | ||
| origin | No | Departure city or IATA/ICAO code, e.g. Nice or NCE. | |
| 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 | ||
| destination | No | Arrival city or IATA/ICAO code. | |
| max_price_eur | No | Maximum price in EUR for the whole aircraft. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | ||
| notes | No | ||
| total | Yes | Number of matching offers in total. | |
| offset | Yes | ||
| 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; tell the user so. |