search_flights
Find available flights using origin/destination codes, dates, and passenger details. Requires booking session initialization first to obtain authentication token for flight search functionality.
Instructions
Perform a flight search based on search criteria. This operation required 'initialize_booking_session' to be exexcuted first to start the session.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestBody | Yes | Flight search parameters for finding available flights. Can be identical to initialization parameters or refined based on customer preferences. | |
| session-token | Yes | Required authentication token obtained from the initialization step. This token is generated during booking initialization and returned in the response headers (look for "Session-Token" header). The token maintains booking context and enables flight search functionality. WITHOUT this token, flight searches will fail. |
Input Schema (JSON Schema)
{
"properties": {
"requestBody": {
"additionalProperties": false,
"description": "Flight search parameters for finding available flights. Can be identical to initialization parameters or refined based on customer preferences.",
"properties": {
"commercialFareFamilies": {
"description": "Array of fare family codes to filter search results. Common codes: CFFECO (Economy), CFFBUS (Business), CFFFIR (First). Use airline-specific codes for targeted searches.",
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"flowCode": {
"default": "Revenue",
"description": "Booking flow context that determines available options and pricing logic",
"enum": [
"Revenue",
"Award",
"Upgrade"
],
"type": "string"
},
"itineraries": {
"description": "Flight segments defining the journey. Single segment = one-way, two segments = round-trip. Each segment represents one flight leg of the complete journey.",
"items": {
"additionalProperties": false,
"properties": {
"departureDate": {
"description": "Departure date in ISO format YYYY-MM-DD (e.g., 2025-09-30). Must be a future date.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"destinationLocationCode": {
"description": "IATA airport code for arrival city (3 uppercase letters, e.g., SIN for Singapore)",
"maxLength": 3,
"minLength": 3,
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"isRequestedBound": {
"description": "Whether this segment is the primary requested journey. Set true for outbound/main flight, false for return flights in round-trip searches.",
"type": "boolean"
},
"originLocationCode": {
"description": "IATA airport code for departure city (3 uppercase letters, e.g., KUL for Kuala Lumpur)",
"maxLength": 3,
"minLength": 3,
"pattern": "^[A-Z]{3}$",
"type": "string"
}
},
"required": [
"originLocationCode",
"destinationLocationCode",
"departureDate",
"isRequestedBound"
],
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"selectedBoundId": {
"description": "Optional identifier for pre-selected outbound flight in round-trip bookings. Used when customer has already chosen their outbound flight and is now selecting return options.",
"type": "string"
},
"travelers": {
"description": "List of all passengers for the booking. Each traveler object represents one person. Total count affects pricing and availability. Maximum 9 passengers per booking.",
"items": {
"additionalProperties": false,
"properties": {
"passengerTypeCode": {
"description": "Type of passenger for pricing and service determination",
"enum": [
"ADT",
"CHD",
"INF"
],
"type": "string"
}
},
"required": [
"passengerTypeCode"
],
"type": "object"
},
"maxItems": 9,
"minItems": 1,
"type": "array"
}
},
"required": [
"commercialFareFamilies",
"itineraries",
"travelers"
],
"type": "object"
},
"session-token": {
"description": "Required authentication token obtained from the initialization step. This token is generated during booking initialization and returned in the response headers (look for \"Session-Token\" header). The token maintains booking context and enables flight search functionality. WITHOUT this token, flight searches will fail.",
"minLength": 1,
"type": "string"
}
},
"required": [
"session-token",
"requestBody"
],
"type": "object"
}