search_flights
Search round-trip flights between two airports for given dates and travelers. Returns BreckenWander's per-traveler round-trip price with taxes and carrier-imposed fees included, plus a link that opens the same search on breckenwander.com to complete the booking. Read-only: does not book or take payment.
Parameters11
| origin | string | required | Origin IATA airport or metro code, e.g. "JFK" or "LON". |
| destination | string | required | Destination IATA airport or metro code, e.g. "LAX" or "CUN". |
| depart_date | string | required | Departure date in YYYY-MM-DD. |
| return_date | string | required | Return date in YYYY-MM-DD. Round-trip only for now. |
| adults | integer | optional | Number of adult travelers. |
| children | integer | optional | Number of child travelers (2-11). |
| infants | integer | optional | Number of infant travelers (under 2). |
| cabin | string | optional | Cabin class. |
| sort | string | optional | Result ordering. 'best' (default) balances price, travel time, and stops; 'price' is strictly lowest fare first; 'duration' is shortest outbound travel time first. |
| max_stops | integer | optional | Maximum stops on the outbound leg. 0 returns nonstop flights only. |
| max_results | integer | optional | How many flight options to return. |
Raw schema
{
"type": "object",
"properties": {
"origin": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Origin IATA airport or metro code, e.g. \"JFK\" or \"LON\"."
},
"destination": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Destination IATA airport or metro code, e.g. \"LAX\" or \"CUN\"."
},
"depart_date": {
"type": "string",
"description": "Departure date in YYYY-MM-DD."
},
"return_date": {
"type": "string",
"description": "Return date in YYYY-MM-DD. Round-trip only for now."
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"default": 1,
"description": "Number of adult travelers."
},
"children": {
"type": "integer",
"minimum": 0,
"maximum": 6,
"default": 0,
"description": "Number of child travelers (2-11)."
},
"infants": {
"type": "integer",
"minimum": 0,
"maximum": 4,
"default": 0,
"description": "Number of infant travelers (under 2)."
},
"cabin": {
"type": "string",
"enum": [
"economy",
"premium_economy",
"business",
"first"
],
"default": "economy",
"description": "Cabin class."
},
"sort": {
"type": "string",
"enum": [
"best",
"price",
"duration"
],
"default": "best",
"description": "Result ordering. 'best' (default) balances price, travel time, and stops; 'price' is strictly lowest fare first; 'duration' is shortest outbound travel time first."
},
"max_stops": {
"type": "integer",
"minimum": 0,
"maximum": 3,
"description": "Maximum stops on the outbound leg. 0 returns nonstop flights only."
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8,
"description": "How many flight options to return."
}
},
"required": [
"origin",
"destination",
"depart_date",
"return_date"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}