Resource
Empty Legs
Returns the available empty-leg flights: listed, not expired, and not blocked. Results are sorted by departure date, earliest first.
GET/open/v1/empty-legsempty_leg:read
Query parameters
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page number. Default 1. Values below 1 are clamped to 1; a page past the last page returns an empty records array. |
| size | integer | Items per page. Default 20, maximum 100. Out-of-range values are clamped into the 1–100 range. |
Out-of-range integer values are clamped, not rejected. A non-integer page or size (e.g. page=abc) returns 400 INVALID_PARAMETER.
Response — data
| Field | Type | Description |
|---|---|---|
| records | EmptyLeg[] | Page of empty legs. |
| total | integer | Total matching legs. |
| page | integer | Current page. |
| size | integer | Page size. |
The EmptyLeg object
| Field | Type | Description |
|---|---|---|
| id | string | Unique empty-leg identifier. |
| startDate | string | Departure date, ISO 8601 yyyy-MM-dd, e.g. "2026-06-17". Local date at the departure location — the departure airport's timezone, or the departure city's timezone when the airport is unknown. |
| endDate | string | Arrival/expiry date, same format. |
| depCityName | string | Departure city. |
| depAirportName | string · null | Departure airport name. May be null. |
| depAirportIcao | string · null | Departure ICAO code, e.g. KTEB. |
| depCountryName | string | Departure country name, e.g. United States. Always present. |
| depCountryCode | string | Departure country ISO 3166-1 alpha-2 code, e.g. US. Always present. |
| arrCityName | string | Arrival city. |
| arrAirportName | string · null | Arrival airport name. May be null. |
| arrAirportIcao | string · null | Arrival ICAO code. |
| arrCountryName | string | Arrival country name. Always present. |
| arrCountryCode | string | Arrival country ISO 3166-1 alpha-2 code. Always present. |
| airlineName | string · null | Operating carrier. |
| aircraftModelName | string · null | Model, e.g. Challenger 850. |
| aircraftType | string · null | Category, e.g. Heavy Jet. |
| registration | string · null | Tail number. |
| aircraftImg | string · null | Aircraft photo URL. |
| makeYear | integer · null | Year of manufacture. |
| renovateYear | integer · null | Year of last refurbishment. |
| price | number · null | Empty-leg price, e.g. 12500.00. May be null. |
| currency | string · null | ISO 4217 currency code, e.g. USD. May be null. |
| amenities | Amenity[] | On-board amenities. |
The Amenity object
| Field | Type | Description |
|---|---|---|
| amenityType | string | Raw type code: wifi, smoking, pets, bed, toilet, medical. |
| amenityName | string | Display name, e.g. WIFI, Bed. |
| amenityDesc | string | Human-readable detail, e.g. WIFI (Extra 3,333 USD/MB), 2 beds, 1 lavatory. |
Request
curl https://openapi.avi-go.com/open/v1/empty-legs?page=1&size=20 \
-H "X-API-Key: ag_live_8f2c9d1b…"Response200 · OK
{
"code": "OK",
"message": "success",
"data": {
"records": [{
"id": "el_3Nf8a2",
"startDate": "2026-06-17",
"endDate": "2026-06-17",
"depCityName": "New York",
"depAirportName": "Teterboro Airport",
"depAirportIcao": "KTEB",
"depCountryName": "United States",
"depCountryCode": "US",
"arrCityName": "West Palm Beach",
"arrAirportName": "Palm Beach Intl",
"arrAirportIcao": "KPBI",
"arrCountryName": "United States",
"arrCountryCode": "US",
"airlineName": "Vista Jet",
"aircraftModelName": "Challenger 850",
"aircraftType": "Heavy Jet",
"registration": "9H-ILI",
"makeYear": 2008,
"renovateYear": 2019,
"price": 12500.00,
"currency": "USD",
"amenities": [
{ "amenityType": "wifi", "amenityName": "WIFI",
"amenityDesc": "WIFI (Extra 3,333 USD/MB)" },
{ "amenityType": "bed", "amenityName": "Bed",
"amenityDesc": "2 beds" },
{ "amenityType": "toilet", "amenityName": "Toilet",
"amenityDesc": "1 lavatory" }
]
}],
"total": 176,
"page": 1,
"size": 20
},
"traceId": "05707ab9-22e9-49aa-ba12-f469c6622131"
}