segments *
array
Array of flight segments. Each segment represents one leg of the journey. For one-way: 1 segment. For round-trip: 2 segments. For multi-city: 3+ segments.
passengers
number
Number of passengers (default: 1)
cabin_class
string
Preferred cabin class (default: 'economy')
max_results
number
Maximum number of flight offers to return (default: 10)
View full schema
{
"type": "object",
"properties": {
"segments": {
"type": "array",
"description": "Array of flight segments. Each segment represents one leg of the journey. For one-way: 1 segment. For round-trip: 2 segments. For multi-city: 3+ segments.",
"items": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"description": "IATA code of the departure airport (e.g., 'JFK', 'LAX', 'LHR')"
},
"destination": {
"type": "string",
"description": "IATA code of the arrival airport (e.g., 'JFK', 'LAX', 'LHR')"
},
"departure_date": {
"type": "string",
"description": "Departure date in ISO 8601 format (e.g., '2025-03-15')"
}
},
"required": [
"origin",
"destination",
"departure_date"
]
},
"minItems": 1,
"maxItems": 6
},
"passengers": {
"type": "number",
"description": "Number of passengers (default: 1)",
"minimum": 1,
"maximum": 9
},
"cabin_class": {
"type": "string",
"description": "Preferred cabin class (default: 'economy')",
"enum": [
"economy",
"premium_economy",
"business",
"first"
]
},
"max_results": {
"type": "number",
"description": "Maximum number of flight offers to return (default: 10)",
"minimum": 1,
"maximum": 50
}
},
"required": [
"segments"
]
}