search_flights
Find and compare flight options for one-way, round-trip, or multi-city journeys with customizable preferences for dates, cabin class, and travel times.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Type of flight | |
| origin | Yes | Origin airport or city IATA code (e.g., SFO, NYC) | |
| destination | Yes | Destination airport or city IATA code (e.g., LAX, LHR) | |
| departureDate | Yes | Departure date in YYYY-MM-DD format | |
| returnDate | No | Return date in YYYY-MM-DD format (required for round-trip) | |
| departureTime | No | Preferred departure time window | |
| arrivalTime | No | Preferred arrival time window | |
| cabinClass | Yes | Cabin class | |
| adults | No | Number of adult passengers | |
| maxConnections | No | Maximum number of connections | |
| additionalStops | No | Additional stops for multi-city flights |
Input Schema (JSON Schema)
{
"properties": {
"additionalStops": {
"description": "Additional stops for multi-city flights",
"items": {
"additionalProperties": false,
"properties": {
"departureDate": {
"description": "Departure date in YYYY-MM-DD format",
"type": "string"
},
"destination": {
"description": "Destination airport or city IATA code (e.g., LAX, LHR)",
"type": "string"
},
"origin": {
"description": "Origin airport or city IATA code (e.g., SFO, NYC)",
"type": "string"
}
},
"required": [
"origin",
"destination",
"departureDate"
],
"type": "object"
},
"type": "array"
},
"adults": {
"default": 1,
"description": "Number of adult passengers",
"minimum": 1,
"type": "number"
},
"arrivalTime": {
"$ref": "#/properties/departureTime",
"description": "Preferred arrival time window"
},
"cabinClass": {
"description": "Cabin class",
"enum": [
"economy",
"premium_economy",
"business",
"first"
],
"type": "string"
},
"departureDate": {
"description": "Departure date in YYYY-MM-DD format",
"type": "string"
},
"departureTime": {
"additionalProperties": false,
"description": "Preferred departure time window",
"properties": {
"fromTime": {
"description": "Start time in 24-hour format (HH:MM)",
"type": "string"
},
"toTime": {
"description": "End time in 24-hour format (HH:MM)",
"type": "string"
}
},
"required": [
"fromTime",
"toTime"
],
"type": "object"
},
"destination": {
"description": "Destination airport or city IATA code (e.g., LAX, LHR)",
"type": "string"
},
"maxConnections": {
"description": "Maximum number of connections",
"type": "number"
},
"origin": {
"description": "Origin airport or city IATA code (e.g., SFO, NYC)",
"type": "string"
},
"returnDate": {
"description": "Return date in YYYY-MM-DD format (required for round-trip)",
"type": "string"
},
"type": {
"description": "Type of flight",
"enum": [
"one_way",
"round_trip",
"multi_city"
],
"type": "string"
}
},
"required": [
"type",
"origin",
"destination",
"departureDate",
"cabinClass"
],
"type": "object"
}