search_flights
Search for flights by specifying origin, destination, dates, and preferences such as cabin class, time range, and connections to plan travel efficiently.
Instructions
Search for flights based on parameters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"FlightSearch": {
"description": "Model for flight search parameters.",
"properties": {
"additional_stops": {
"anyOf": [
{
"items": {
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Additional stops for multi-city trips",
"title": "Additional Stops"
},
"adults": {
"default": 1,
"description": "Number of adult passengers",
"title": "Adults",
"type": "integer"
},
"arrival_time": {
"anyOf": [
{
"$ref": "#/$defs/TimeSpec"
},
{
"type": "null"
}
],
"default": null,
"description": "Preferred arrival time range"
},
"cabin_class": {
"default": "economy",
"description": "Cabin class (economy, business, first)",
"title": "Cabin Class",
"type": "string"
},
"departure_date": {
"description": "Departure date (YYYY-MM-DD)",
"title": "Departure Date",
"type": "string"
},
"departure_time": {
"anyOf": [
{
"$ref": "#/$defs/TimeSpec"
},
{
"type": "null"
}
],
"default": null,
"description": "Preferred departure time range"
},
"destination": {
"description": "Destination airport code",
"title": "Destination",
"type": "string"
},
"max_connections": {
"default": null,
"description": "Maximum number of connections (0 for non-stop)",
"title": "Max Connections",
"type": "integer"
},
"origin": {
"description": "Origin airport code",
"title": "Origin",
"type": "string"
},
"return_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Return date for round trips (YYYY-MM-DD)",
"title": "Return Date"
},
"type": {
"description": "Type of flight: 'one_way', 'round_trip', or 'multi_city'",
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"origin",
"destination",
"departure_date"
],
"title": "FlightSearch",
"type": "object"
},
"TimeSpec": {
"description": "Model for time range specification.",
"properties": {
"from_time": {
"description": "Start time (HH:MM)",
"pattern": "^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$",
"title": "From Time",
"type": "string"
},
"to_time": {
"description": "End time (HH:MM)",
"pattern": "^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$",
"title": "To Time",
"type": "string"
}
},
"required": [
"from_time",
"to_time"
],
"title": "TimeSpec",
"type": "object"
}
},
"properties": {
"params": {
"$ref": "#/$defs/FlightSearch"
}
},
"required": [
"params"
],
"title": "search_flightsArguments",
"type": "object"
}