Search
Search for flights
POST /flight/availability
Use this API to search for available flights based on specified criteria.
Headers
Content-Type*
application/json
VOLZ-API-KEY*
<api_key>
VOLZ-API-SECRET*
<api_secret>
Accept-Language
en|fr|ar
Response Headers
Volz-Request-Ref
<uuid>
This value should be kept and forwarded to the next steps of the API, it is useful when it comes to resolving any of the issues that you might encounter
Body
trip_type*
string
Possible values:
OW: One Way
RT: Round Trip
MD: Multi-Destination
destinations*
array
Destinations information
destinations.*.origin*
string
IATA Code of the departure airport
destinations.*.destination*
string
IATA Code of the arrival airport
destinations.*.departure_date*
date
Departure date using format
Y-m-d ex: 2024-08-07
destinations.*.return_date
date
ONLY FOR ROUND TRIPS
Return date using format
Y-m-d ex: 2024-08-07
adults*
int
Number of adults
children*
int
Number of children
held_infants*
int
Number of seated infants
refundable*
bool
If true, results will only contain refundable flights
luggage_included*
bool
If true, results will only contain luggage included flights
cabin*
string
Possible values:
ECONOMY, PREMIUM_ECONOMY,
ECONOMY_STANDARD,
BUSINESS,FIRST
air_companies
array
Filter only show flights operated by these companies
itinerary_x_stops
int
Number of stops in the Xth itinerary ex:
itinerary_0_stops: 1
Can be used as many as the number of destinations selected
departure_time_min
string
Minimum departure time formatted as follows:
H:i ex 00:30
This will only display flights that have a departure time after 00:30
departure_time_max
string
Maximum departure time formatted as follows:
H:i ex 00:30
arrival_time_min
string
Minimum arrival time formatted as follows:
H:i ex 00:30
arrival_time_max
string
Maximum arrival time formatted as follows:
H:i ex 00:30
Response
{
"data": [
{
"id": "2-2",
"numberOfBookableSeats": 9,
"domesticFlight": false,
"itineraries": [
{
"totalDuration": 405,
"duration": "06:45",
"fromDate": "2025-08-10T22:05:00",
"toDate": "2025-08-11T07:50:00",
"numOfStops": null,
"airportChange": null,
"segments": [
{
"id": "164",
"departure": {
"iataCode": "ALG",
"terminal": "4",
"at": "2025-08-10T22:05:00"
},
"arrival": {
"iataCode": "DXB",
"terminal": "1",
"at": "2025-08-11T07:50:00"
},
"flightNumber": null,
"carrier": null,
"operatingCarrier": null,
"aircraft": {
"code": "332"
},
"duration": "PT6H45M"
}
]
}
],
"price": {
"currency": "DZD",
"total": 47477
},
"travelerPricings": [
{
"travelerId": "1",
"fareOption": "STANDARD",
"travelerType": "ADULT",
"price": {
"currency": "DZD",
"total": 44957
},
"fareDetailsBySegment": [
{
"segmentId": "164",
"cabin": "ECONOMY",
"fareBasis": "QDZAEOO",
"brandedFare": null,
"brandedFareLabel": null,
"class": "Q",
"includedCheckedBags": {
"quantity": 2
}
}
]
}
]
}
],
"total": 43,
"page": 1,
"per_page": 20,
"meta": [],
"search_code": "0ee47dcdf6224432143c1b01d6c4089d",
"filters": {
"cheapests": {
"EK": 51422,
"TK": 70193,
"LH": 254486,
"AZ": 229234,
"BA": 270709,
"AC": 536943,
"AH": 47477
}
},
"dictionaries": {
"locations": {
"FCO": {
"cityCode": "ROM",
"countryCode": "IT",
"airport": "Rome–Fiumicino International Airport",
"city": "Rome"
},
"FRA": {
"cityCode": "FRA",
"countryCode": "DE",
"airport": "Frankfurt Airport",
"city": "Francfort"
},
"ATH": {
"cityCode": "ATH",
"countryCode": "GR",
"airport": "Athens International Airport (Eleftherios Venizelos Airport)",
"city": "Athènes"
},
"IST": {
"cityCode": "IST",
"countryCode": "TR",
"airport": "Istanbul Ataturk Airport",
"city": "Istanbul"
},
"YYZ": {
"cityCode": "YTO",
"countryCode": "CA",
"airport": "Toronto Pearson International Airport",
"city": "Toronto"
},
"ALG": {
"cityCode": "ALG",
"countryCode": "DZ",
"airport": "Houari Boumediene Airport algiers",
"city": "Alger"
},
"LGW": {
"cityCode": "LON",
"countryCode": "GB",
"airport": "Gatwick Airport",
"city": "Londres"
},
"DXB": {
"cityCode": "DXB",
"countryCode": "AE",
"airport": "Dubai International Airport",
"city": "Dubai"
},
"AMM": {
"cityCode": "AMM",
"countryCode": "JO",
"airport": "Queen Alia International Airport",
"city": "Amman"
},
"RUH": {
"cityCode": "RUH",
"countryCode": "SA",
"airport": "King Khalid International Airport Riyad",
"city": "Riyadh"
},
"CDG": {
"cityCode": "PAR",
"countryCode": "FR",
"airport": "Paris Charles de Gaulle Airport",
"city": "Paris"
},
"LYS": {
"cityCode": "LYS",
"countryCode": "FR",
"airport": "Lyon-Saint-Exupery Airport",
"city": "Lyon"
},
"SAW": {
"cityCode": "IST",
"countryCode": "TR",
"airport": "Sabiha Gokcen International Airport",
"city": "Istanbul"
},
"JED": {
"cityCode": "JED",
"countryCode": "SA",
"airport": "King Abdulaziz International Airport Jeddah",
"city": "Jeddah"
},
"TUN": {
"cityCode": "TUN",
"countryCode": "TN",
"airport": "Tunis–Carthage International Airport",
"city": "Tunis"
},
"BCN": {
"cityCode": "BCN",
"countryCode": "ES",
"airport": "Barcelona El Prat Airport",
"city": "Barcelone"
},
"XNB": {
"cityCode": "DXB",
"countryCode": "AE",
"airport": "",
"city": ""
},
"MAD": {
"cityCode": "MAD",
"countryCode": "ES",
"airport": "Adolfo Suarez Madrid-Barajas Airport",
"city": "Madrid"
},
"NCE": {
"cityCode": "NCE",
"countryCode": "FR",
"airport": "Nice Cote d'Azur Airport",
"city": "Nice"
},
"GVA": {
"cityCode": "GVA",
"countryCode": "CH",
"airport": "Geneva Airport",
"city": "Genève"
},
"AUH": {
"cityCode": "AUH",
"countryCode": "AE",
"airport": "Abu Dhabi International Airport",
"city": "Abu Dhabi"
},
"DOH": {
"cityCode": "DOH",
"countryCode": "QA",
"airport": "Hamad International Airport Doha",
"city": "Doha"
},
"MCT": {
"cityCode": "MCT",
"countryCode": "OM",
"airport": "Muscat International Airport",
"city": "Muscat"
}
},
"aircraft": {
"221": "AIRBUS A220-100",
"295": "EMBRAER 195 E2",
"319": "AIRBUS A319",
"320": "AIRBUS A320",
"321": "AIRBUS A321",
"330": "AIRBUS INDUSTRIE A330",
"332": "AIRBUS A330-200",
"333": "AIRBUS A330-300",
"359": "AIRBUS A350-900",
"388": "AIRBUS A380-800",
"736": "BOEING 737-600",
"738": "BOEING 737-800",
"744": "BOEING 747-400",
"777": "BOEING 777-200/300",
"781": "BOEING 787-10",
"787": "787 ALL SERIES PASSENGER",
"789": "BOEING 787-9",
"32Q": "AIRBUS A321NEO",
"32A": "AIRBUS A320 (SHARKLETS)",
"32B": "AIRBUS A321 (SHARKLETS)",
"32S": "AIRBUS INDUSTRIE A318/A319/A320/A321",
"77W": "BOEING 777-300ER",
"74H": "BOEING 747-8",
"BUS": "SURFACE EQUIPMENT-BUS",
"7M8": "BOEING 737 MAX 8",
"73H": "BOEING 737-800 (WINGLETS)",
"77L": "BOEING 777-200LR",
"32N": "AIRBUS A320NEO"
},
"currencies": {
"DZD": "ALGERIAN DINAR"
},
"carriers": {
"6X": "AMADEUS SIX",
"AC": "AIR CANADA",
"EK": "EMIRATES",
"TK": "TURKISH AIRLINES",
"AZ": "ITA AIRWAYS",
"LH": "LUFTHANSA",
"BA": "BRITISH AIRWAYS",
"A0": "BA EUROFLYER",
"QR": "QATAR AIRWAYS",
"WY": "OMAN AIR",
"SV": "SAUDI ARABIAN AIRLINES",
"VY": "VUELING AIRLINES",
"AF": "AIR FRANCE",
"AH": "AIR ALGERIE",
"VF": "AJET",
"FZ": "FLYDUBAI",
"EY": "ETIHAD AIRWAYS",
"RJ": "ROYAL JORDANIAN"
}
}
}Last updated