The Amadeus Flight Booking Journey - API Calls
The Amadeus Flight Booking service consists of three separate API calls. The first of these is the Flight Offers Search
The following code snippet represents the Flight Offers Search called from a python environment
# Install the Python library from https://pypi.org/project/amadeus
from amadeus import Client, ResponseError
amadeus = Client(
client_id='your_client_id',
client_secret='your_client_secret'
)
try:
'''
Find the cheapest flights from BHX to SVQ
'''
response = amadeus.shopping.flight_offers_search.get(
currencyCode='GBP',
originLocationCode='BHX',
destinationLocationCode='SVQ',
departureDate='2025-06-21',
adults=1,
children=0,
infants=0,
max=1)
print(response.data)
except ResponseError as error:
raise error
From a correctly invoked python environment - call flight_offers_search.py
The service retures -
"type": "flight-offer",
"id": "1",
"source": "GDS",
"instantTicketingRequired": false,
"nonHomogeneous": false,
"oneWay": false,
"isUpsellOffer": false,
"lastTicketingDate": "2025-05-22",
"lastTicketingDateTime": "2025-05-22",
"numberOfBookableSeats": 9,
"itineraries": [
{
"duration": "PT15H25M",
"segments": [
{
"departure": {"iataCode": "BHX", "at": "2025-06-21T17:35:00"},
"arrival": {"iataCode": "AMS", "at": "2025-06-21T19:50:00"},
"carrierCode": "KL",
"number": "1048",
"aircraft": {"code": "73H"},
"operating": {"carrierCode": "KL"},
"duration": "PT1H15M",
"id": "1",
"numberOfStops": 0,
"blacklistedInEU": false
},
{
"departure": {"iataCode": "AMS", "at": "2025-06-22T07:05:00"},
"arrival": {"iataCode": "SVQ", "at": "2025-06-22T10:00:00"},
"carrierCode": "KL",
"number": "2544",
"aircraft": {"code": "32Q"},
"operating": {"carrierCode": "HV"},
"duration": "PT2H55M",
"id": "2",
"numberOfStops": 0,
"blacklistedInEU": false
}
]
}
],
"price": {
"currency": "GBP",
"total": "166.17",
"base": "86.00",
"fees": [
{"amount": "0.00", "type": "SUPPLIER" },
{"amount": "0.00", "type": "TICKETING"}
],
"grandTotal": "166.17"
},
"pricingOptions": {
"fareType": ["PUBLISHED"],
"includedCheckedBagsOnly": true
},
"validatingAirlineCodes": ["AF"],
"travelerPricings": [
{
"travelerId": "1",
"fareOption": "STANDARD",
"travelerType": "ADULT",
"price": {"currency": "GBP", "total": "166.17", "base": "86.00"},
"fareDetailsBySegment": [
{
"segmentId": "1",
"cabin": "ECONOMY",
"fareBasis": "GYQFBBSA",
"brandedFare": "STANDARD",
"brandedFareLabel": "ECONOMY STANDARD",
"class": "G",
"includedCheckedBags": {"quantity": 1},
"includedCabinBags": {"quantity": 1},
"amenities": [
{
"description": "SNACK",
"isChargeable": false,
"amenityType": "MEAL",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "BEVERAGE",
"isChargeable": false,
"amenityType": "MEAL",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "SEAT SELECTION",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "MILEAGE ACCRUAL",
"isChargeable": false,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "UPGRADE ELIGIBILITY",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "CHANGEABLE TICKET",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
}
]
},
{
"segmentId": "2",
"cabin": "ECONOMY",
"fareBasis": "GYQFBBSA",
"brandedFare": "STANDARD",
"brandedFareLabel": "ECONOMY STANDARD",
"class": "G",
"includedCheckedBags": {"quantity": 1},
"amenities": [
{
"description": "SNACK",
"isChargeable": false,
"amenityType": "MEAL",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "BEVERAGE",
"isChargeable": false,
"amenityType": "MEAL",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "SEAT SELECTION",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "MILEAGE ACCRUAL",
"isChargeable": false,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "UPGRADE ELIGIBILITY",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
},
{
"description": "CHANGEABLE TICKET",
"isChargeable": true,
"amenityType": "BRANDED_FARES",
"amenityProvider": {"name": "BrandedFare"}
}
]
}
]
}
]
}
The successful generation of flight offers marks the end of the first api call. The second api call, flight offers price is required to confirm the selected flight is still valid. This call is typically invoked on booking.
(amadeus) [ec2-user@ip-172-31-12-162 amadeus-flight-booking-django]$ python api/code-example-price.py
The call returns the proposed booking details with any caveats to the original request if any.
"warnings": [
{
"code": 0,
"title": "PricingOrFareBasisDiscrepancyWarning",
"detail": "Actual price and/or fare basis for some passengers is different from requested ones",
"status": 200
}
],
"data": {
"type": "flight-offers-pricing",
"flightOffers": [
{
"type": "flight-offer",
"id": "1",
"source": "GDS",
"instantTicketingRequired": false,
"nonHomogeneous": false,
"paymentCardRequired": false,
"lastTicketingDate": "2025-05-27",
"itineraries": [
{
"segments": [
{
"departure": {
"iataCode": "BHX",
"at": "2025-06-21T17:35:00"
},
"arrival": {
"iataCode": "AMS",
"at": "2025-06-21T19:50:00"
},
"carrierCode": "KL",
"number": "1048",
"aircraft": {
"code": "73H"
},
"operating": {
"carrierCode": "KL"
},
"duration": "PT1H15M",
"id": "17",
"numberOfStops": 0,
"co2Emissions": [
{
"weight": 64,
"weightUnit": "KG",
"cabin": "ECONOMY"
}
]
},
{
"departure": {
"iataCode": "AMS",
"at": "2025-06-22T07:05:00"
},
"arrival": {
"iataCode": "SVQ",
"at": "2025-06-22T10:00:00"
},
"carrierCode": "KL",
"number": "2544",
"aircraft": {
"code": "32Q"
},
"operating": {
"carrierCode": "HV"
},
"duration": "PT2H55M",
"id": "18",
"numberOfStops": 0,
"co2Emissions": [
{
"weight": 117,
"weightUnit": "KG",
"cabin": "ECONOMY"
}
]
}
]
}
],
"price": {
"currency": "GBP",
"total": "177.17",
"base": "97.00",
"fees": [
{
"amount": "0.00",
"type": "SUPPLIER"
},
{
"amount": "0.00",
"type": "TICKETING"
},
{
"amount": "0.00",
"type": "FORM_OF_PAYMENT"
}
],
"grandTotal": "177.17",
"billingCurrency": "GBP"
},
"pricingOptions": {
"fareType": [
"PUBLISHED"
],
"includedCheckedBagsOnly": true
},
"validatingAirlineCodes": [
"AF"
],
"travelerPricings": [
{
"travelerId": "1",
"fareOption": "STANDARD",
"travelerType": "ADULT",
"price": {
"currency": "GBP",
"total": "177.17",
"base": "97.00",
"taxes": [
{
"amount": "10.50",
"code": "CJ"
},
{
"amount": "20.00",
"code": "YQ"
},
{
"amount": "1.25",
"code": "YR"
},
{
"amount": "13.00",
"code": "GB"
},
{
"amount": "12.10",
"code": "RN"
},
{
"amount": "23.32",
"code": "UB"
}
],
"refundableTaxes": "58.92"
},
"fareDetailsBySegment": [
{
"segmentId": "17",
"cabin": "ECONOMY",
"fareBasis": "XYQDBBSA",
"brandedFare": "STANDARD",
"class": "X",
"includedCheckedBags": {
"quantity": 1
}
},
{
"segmentId": "18",
"cabin": "ECONOMY",
"fareBasis": "XYQDBBSA",
"brandedFare": "STANDARD",
"class": "X",
"includedCheckedBags": {
"quantity": 1
}
}
]
}
]
}
],
"bookingRequirements": {
"emailAddressRequired": true,
"mobilePhoneNumberRequired": true
}
},
"dictionaries": {
"locations": {
"BHX": {
"cityCode": "BHX",
"countryCode": "GB"
},
"AMS": {
"cityCode": "AMS",
"countryCode": "NL"
},
"SVQ": {
"cityCode": "SVQ",
"countryCode": "ES"
}
}
}
}
Caveats
.This blog is mostly about helping small and medium sized businesses use technology. Size necessarily dictates different priorities but the ability to apply the tools available to differentiate your online presence should not be a constraint to growing your business. Helping you bring your ideas to fruition is what we’re about. Perhaps developing ways which allow you to better connect with your customers by implementing a new service platform or simply a rejuvenation of your website...
Know more!