Search
K
LLM Flight Booking Assistant

Search for available flights

Returns a list of available flights matching the criteria.

get

Query Parameters

originstringrequired

IATA airport code

Match pattern:^[A-Z]{3}$

Example:DEN

destinationstringrequired

IATA airport code

Match pattern:^[A-Z]{3}$

Example:DEN

departureDatestring(date)required
returnDatestring(date)
cabinClassstring

Allowed values:economypremium_economybusinessfirst

limitinteger

Page size

>= 1<= 100

offsetinteger

Pagination offset

>= 0

Headers

Accept-Languagestring

Preferred language for response

X-Correlation-IDstring(uuid)

Correlation identifier for tracing

Response

application/json

Successful search

FlightSearchResponse

flightsarray[object]required

Example:{"id":"f7d5d7c8-9b3e-4a0e-93e0-3bb08f75df0f","airline":"Example Air","flightNumber":"EA123","origin":{"code":"DEN","name":"Denver International Airport","city":"Denver","country":"USA"},"destination":{"code":"LAX","name":"Los Angeles International Airport","city":"Los Angeles","country":"USA"},"departureTime":"2025-06-01T08:00:00Z","arrivalTime":"2025-06-01T10:00:00Z","durationMinutes":120,"aircraft":"Boeing 737","seatsAvailable":42}

Show Child Parameters
paginationobject
Show Child Parameters

Callbacks

post
{$request.body#/callbackUrl}

Callback Response

204

Received

get/flights/search
 
application/json
callback sample
Callback Body
Callback Response
204

Book a flight

Books a flight and returns booking confirmation.

post

Headers

X-Correlation-IDstring(uuid)

Correlation identifier for tracing

Body

application/json

Booking request body

BookingRequest

flightIdstring(uuid)required
passengersarray[object]required
Show Child Parameters
paymentOne Of
objectrequired
CreditCardobject
Show Child Parameters

Response

application/json

Booking created

BookingResponse

flightIdstring(uuid)required
passengersarray[object]required
Show Child Parameters
paymentOne Of
required
CreditCardobject
Show Child Parameters
bookingIdstring(uuid)required
statusstringrequired

Allowed values:pendingconfirmedcancelled

totalPriceobject
Show Child Parameters
post/flights/book

Body

{ "flightId": "flightId", "passengers": [ { "firstName": "firstName", "lastName": "lastName", "dateOfBirth": "dateOfBirth" } ], "payment": {} }
 
application/json

Retrieve booking details

get

Path Parameters

bookingIdstring(uuid)required

Response

application/json

Booking details

BookingResponse

flightIdstring(uuid)required
passengersarray[object]required
Show Child Parameters
paymentOne Of
required
CreditCardobject
Show Child Parameters
bookingIdstring(uuid)required
statusstringrequired

Allowed values:pendingconfirmedcancelled

totalPriceobject
Show Child Parameters
get/flights/{bookingId}
 
application/json

Modify booking

patch

Path Parameters

bookingIdstring(uuid)required

Body

application/json

Booking patch request body

BookingPatchRequest

addPassengerobject
Show Child Parameters
removePassengerIdstring(uuid)

Response

application/json

Booking updated

BookingResponse

flightIdstring(uuid)required
passengersarray[object]required
Show Child Parameters
paymentOne Of
required
CreditCardobject
Show Child Parameters
bookingIdstring(uuid)required
statusstringrequired

Allowed values:pendingconfirmedcancelled

totalPriceobject
Show Child Parameters
patch/flights/{bookingId}

Body

{}
 
application/json

Cancel booking

delete

Path Parameters

bookingIdstring(uuid)required

Response

Booking cancelled

delete/flights/{bookingId}