You can use this endpoint to compare rates from a variety of sources, including GDS, NDC, and direct airlines, to get your precisely desired itinerary. You can search for one-way, round-trip, and multicity flights, as well as set preferences such as fare type, cabin type, alternate days, direct flights, refundable tickets, nearby airports, and free baggage. As a result, you will be able to get more accurate preferred results.
Schema
Party
This is an optional field.
-
Travel Agency Sender:
-
Name: Provide the name for the request. This is a String value.
-
IATA Number: Provide the IATA number for the request. This is a String value.
-
Agency ID: Provide the agency ID for the request. This is a String value.
-
Contacts:
- EmailContact: Provide the email contact for the request. This is a String value.
-
CoreQuery
- OriginDestination: This is an Array and a required field.
You must provide the Departure and Arrival details to get the shopping details.
Note:
AirportCodemust be different for both theDepartureandArrivalto avoid any exceptions.
We are providing the following three options to enhance your air-shopping experience.
- One Way
- Return
- Openjaw/Multicity
DataLists
- Passenger: This is an Array
Note: This is a required field. The passenger list must have at least one adult. Infant object count should be less than or equal to the adult count. More than nine passengers are not accepted.
-
PassengerID: Provide the passenger ID for the request. This is a String value.
-
PTC: Provide the passenger type. Valid values are
ADT,CHD, andINF. This is a String value.
Preference
This is an optional field. You can fill the travel preferences for the air shopping request.
-
TripType: Provide your preferred trip type. Default value is One Way. Valid values are
ONEWAY,ROUND,MULTI, andOPENJAW. This is a String value. -
CabinType: This is an Array. Provide your preferred cabin type. Default value is Y:ECONOMY. Valid values are
Y: ECONOMY,S: PREM ECONOMY,C: BUSINESS,D: PREMBUSINESS,F: FIRSTCLASS, andP: PREMFIRSTCLASS. -
FareType: Provide your preferred fare type. Default value is 70J Public. Valid values are
70J:PUB,749:PRI, and750:Both. This is a String value. -
AdditionalCabinType: Provide the additional cabin type. Valid values are:
S: PREM ECONOMY,C: BUSINESS,D: PREMBUSINESS,F:FIRSTCLASS, andP: PREMFIRSTCLASS. This is a String value. -
NoOfStops: Provide the required number of stops. Valid values are
""and0. This is a Numeric value. -
NearByAirports: Provide if there is any airport present nearby. Default value is N. Valid values are
YandN. This is a String value. -
FreeBaggage: Provide if you want to request for free baggage. Default value is N. Valid values are
YandN. This is a String value. -
CountryPreference: Provide the Preferred country, or Exclude country. This is a String value.
-
AirlinePreference: Provide the Preferred airlines, or Exclude airlines. This is a String value.
-
StopPreference: Provide the Preferred stops or Exclude stops. This is a String value.
-
Currency: Provide the details to make a currency request. Default Value is CAD. Valid values are
CAD,INR,USD, andSGD. This is a String value. -
Penalties: This is a String value.
- Refundable: Provide the details to request a refund. Default value is N. Valid values are
YandN.
- Refundable: Provide the details to request a refund. Default value is N. Valid values are
Metadata
TraceId: Provide the trace ID. This is a String value.
Request URL
curl --location --request POST 'https://newapi.tltid.com/AirShopping' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
Request Body
{
"AirShoppingRQ": {
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "EXTERNAL API TESTING AGENCY",
"IATA_Number": "",
"AgencyID": "EXTERNAL API TESTING AGENCY",
"Contacts": {
"Contact": [
{
"EmailContact": "ba.laqaems@gmail.com"
}
]
}
}
}
},
"CoreQuery": {
"OriginDestinations": {
"OriginDestination": [
{
"Departure": {
"AirportCode": "MAA",
"Date": "2021-10-25"
},
"Arrival": {
"AirportCode": "DXB"
}
}
]
}
},
"DataLists": {
"PassengerList": {
"Passenger": [
{
"PassengerID": "T1",
"PTC": "ADT"
}
]
}
},
"Preference": {
"TripType": "Return",
"CabinType": "Y",
"FareType": [
"70J",
"749"
],
"AdditionalCabinType": [],
"AlternateDays": 0,
"NoOfStops": "",
"NearByAirports": "N",
"FreeBaggage": "N",
"CountryPreference": {
"ExcludeCountry": [],
"PreferedCountry": []
},
"AirlinePreference": {
"PreferedAirlines": [],
"ExcludeAirlines": []
},
"StopPreference": {
"PreferedStops": [],
"ExcludeStops": []
},
"Currency": "CAD",
"TicketingLimit": {
"From": "2021-04-07T07:35",
"To": "2021-05-07T07:35"
},
"Penalties": {
"Refundable": "N"
},
},
"MetaData": {
"TraceId": "161777799749"
}
}
}
Response Sample
{
"AirShoppingRS": {
"Document": {
"Name": "Clarity NDC GATEWAY",
"ReferenceVersion": "1.2"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "EXTERNAL API TESTING AGENCY",
"IATA_Number": "",
"AgencyID": "EXTERNAL API TESTING AGENCY",
"Contacts": {
"Contact": [
{
"EmailContact": "ba.laqaems@gmail.com"
}
]
}
}
}
},
"ShoppingResponseId": "1626691520930374611",
"Success": {},
"OffersGroup": {
"AirlineOffers": [
{
"AirlineOfferSnapshot": {
"PassengerQuantity": 1,
"MatchedOfferQuantity": 2,
"Lowest": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
},
"Highest": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
}
},
"Offer": [
{
"OfferID": "83071221626691521963836801",
"Owner": "SQ",
"OwnerName": "Singapore Airlines",
"TicketType": "Single",
"IsBrandedFare": "N",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "true",
"AllowHold": "N",
"TimeLimits": {
"OfferExpirationDateTime": "2021-07-19T12:45:21",
"PaymentExpirationDateTime": "2021-07-20 03:00:00"
},
"PassportRequired": "N",
"BookingCurrencyCode": "CAD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "",
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"TotalPrice": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
},
"BasePrice": {
"BookingCurrencyPrice": 537,
"EquivCurrencyPrice": 537
},
"TaxPrice": {
"BookingCurrencyPrice": 56.06,
"EquivCurrencyPrice": 56.06
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Penalty": {
"ChangeFee": {
"Before": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"After": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"CancelationFee": {
"Before": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"After": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
}
},
"OfferItem": [
{
"OfferItemID": "OFFERITEMID1",
"Refundable": "true",
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight1"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
},
"BaseAmount": {
"BookingCurrencyPrice": 537,
"EquivCurrencyPrice": 537
},
"TaxAmount": {
"BookingCurrencyPrice": 56.06,
"EquivCurrencyPrice": 56.06
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"BookingFee": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Taxes": [
{
"TaxCode": "ZR",
"BookingCurrencyPrice": 1.71,
"EquivCurrencyPrice": 1.71
},
{
"TaxCode": "IN",
"BookingCurrencyPrice": 1.38,
"EquivCurrencyPrice": 1.38
},
{
"TaxCode": "K38",
"BookingCurrencyPrice": 26.85,
"EquivCurrencyPrice": 26.85
},
{
"TaxCode": "P2",
"BookingCurrencyPrice": 17.78,
"EquivCurrencyPrice": 17.78
},
{
"TaxCode": "L7",
"BookingCurrencyPrice": 2.78,
"EquivCurrencyPrice": 2.78
},
{
"TaxCode": "SG",
"BookingCurrencyPrice": 5.56,
"EquivCurrencyPrice": 5.56
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment1 Segment2",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1 FG_1",
"Code": "V15IIRB1SC1 V15IIRB1SC1"
},
"RBD": "V V",
"CabinType": "Y Y",
"SeatLeft": "8 8"
}
}
]
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment1 Segment2",
"PassengerRefs": "T1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "83071221626691521963836801",
"MultipleFop": "Y",
"MaxCardsPerPax": 2,
"MaxCardsPerPaxInMFOP": 1
}
],
"BookingToEquivExRate": 1,
"FopRef": "FOP_282_282_712_0_ALL_PRI"
},
{
"OfferID": "83071221626691521963670941",
"Owner": "SQ",
"OwnerName": "Singapore Airlines",
"TicketType": "Single",
"IsBrandedFare": "N",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "true",
"AllowHold": "N",
"TimeLimits": {
"OfferExpirationDateTime": "2021-07-19T12:45:21",
"PaymentExpirationDateTime": "2021-07-20 03:00:00"
},
"PassportRequired": "N",
"BookingCurrencyCode": "CAD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "",
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"TotalPrice": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
},
"BasePrice": {
"BookingCurrencyPrice": 537,
"EquivCurrencyPrice": 537
},
"TaxPrice": {
"BookingCurrencyPrice": 56.06,
"EquivCurrencyPrice": 56.06
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Penalty": {
"ChangeFee": {
"Before": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"After": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"CancelationFee": {
"Before": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"After": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
}
},
"OfferItem": [
{
"OfferItemID": "OFFERITEMID1",
"Refundable": "true",
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight2"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 593.06,
"EquivCurrencyPrice": 593.06
},
"BaseAmount": {
"BookingCurrencyPrice": 537,
"EquivCurrencyPrice": 537
},
"TaxAmount": {
"BookingCurrencyPrice": 56.06,
"EquivCurrencyPrice": 56.06
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"BookingFee": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Taxes": [
{
"TaxCode": "ZR",
"BookingCurrencyPrice": 1.71,
"EquivCurrencyPrice": 1.71
},
{
"TaxCode": "IN",
"BookingCurrencyPrice": 1.38,
"EquivCurrencyPrice": 1.38
},
{
"TaxCode": "K38",
"BookingCurrencyPrice": 26.85,
"EquivCurrencyPrice": 26.85
},
{
"TaxCode": "P2",
"BookingCurrencyPrice": 17.78,
"EquivCurrencyPrice": 17.78
},
{
"TaxCode": "L7",
"BookingCurrencyPrice": 2.78,
"EquivCurrencyPrice": 2.78
},
{
"TaxCode": "SG",
"BookingCurrencyPrice": 5.56,
"EquivCurrencyPrice": 5.56
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment3 Segment4",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1 FG_1",
"Code": "V15IIRB1SC1 V15IIRB1SC1"
},
"RBD": "V V",
"CabinType": "Y Y",
"SeatLeft": "8 8"
}
}
]
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment3 Segment4",
"PassengerRefs": "T1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "83071221626691521963670941",
"MultipleFop": "Y",
"MaxCardsPerPax": 2,
"MaxCardsPerPaxInMFOP": 1
}
],
"BookingToEquivExRate": 1,
"FopRef": "FOP_282_282_712_0_ALL_PRI"
}
]
}
]
},
"DataLists": {
"PassengerList": {
"Passengers": [
{
"PassengerID": "T1",
"PTC": "ADT"
}
]
},
"DisclosureList": {
"Disclosures": []
},
"FareList": {
"FareGroup": [
{
"FareGroupRef": "FG_1",
"FareCode": "749",
"FareBasisCode": "V15IIRB1SC1"
}
]
},
"FlightSegmentList": {
"FlightSegment": [
{
"SegmentKey": "Segment1",
"Departure": {
"AirportCode": "MAA",
"Date": "2021-10-25",
"Time": "01:30:00",
"AirportName": "Chennai International Airport",
"Terminal": {
"Name": "4"
}
},
"Arrival": {
"AirportCode": "SIN",
"Date": "2021-10-25",
"Time": "08:20:00",
"AirportName": "Singapore Changi International Airport",
"Terminal": {
"Name": "0"
}
},
"MarketingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "527"
},
"OperatingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "527"
},
"Equipment": {
"AircraftCode": "787",
"Name": "787"
},
"Code": {
"MarriageGroup": "O"
},
"FlightDetail": {
"FlightDuration": {
"Value": "4 H 20 M"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": 1817
},
"BrandId": ""
},
{
"SegmentKey": "Segment2",
"Departure": {
"AirportCode": "SIN",
"Date": "2021-10-25",
"Time": "15:10:00",
"AirportName": "Singapore Changi International Airport",
"Terminal": {
"Name": "3"
}
},
"Arrival": {
"AirportCode": "DXB",
"Date": "2021-10-25",
"Time": "18:25:00",
"AirportName": "Dubai International Airport",
"Terminal": {
"Name": "3"
}
},
"MarketingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "494"
},
"OperatingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "494"
},
"Equipment": {
"AircraftCode": "359",
"Name": "359"
},
"Code": {
"MarriageGroup": "I"
},
"FlightDetail": {
"FlightDuration": {
"Value": "7 H 15 M"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": 3633
},
"BrandId": ""
},
{
"SegmentKey": "Segment3",
"Departure": {
"AirportCode": "MAA",
"Date": "2021-10-25",
"Time": "23:15:00",
"AirportName": "Chennai International Airport",
"Terminal": {
"Name": "4"
}
},
"Arrival": {
"AirportCode": "SIN",
"Date": "2021-10-26",
"Time": "06:10:00",
"AirportName": "Singapore Changi International Airport",
"Terminal": {
"Name": "0"
}
},
"MarketingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "529"
},
"OperatingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "529"
},
"Equipment": {
"AircraftCode": "787",
"Name": "787"
},
"Code": {
"MarriageGroup": "O"
},
"FlightDetail": {
"FlightDuration": {
"Value": "4 H 25 M"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": 1817
},
"BrandId": ""
},
{
"SegmentKey": "Segment4",
"Departure": {
"AirportCode": "SIN",
"Date": "2021-10-26",
"Time": "15:10:00",
"AirportName": "Singapore Changi International Airport",
"Terminal": {
"Name": "3"
}
},
"Arrival": {
"AirportCode": "DXB",
"Date": "2021-10-26",
"Time": "18:25:00",
"AirportName": "Dubai International Airport",
"Terminal": {
"Name": "3"
}
},
"MarketingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "494"
},
"OperatingCarrier": {
"AirlineID": "SQ",
"Name": "Singapore Airlines",
"FlightNumber": "494"
},
"Equipment": {
"AircraftCode": "359",
"Name": "359"
},
"Code": {
"MarriageGroup": "I"
},
"FlightDetail": {
"FlightDuration": {
"Value": "7 H 15 M"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": 3633
},
"BrandId": ""
}
]
},
"FlightList": {
"Flight": [
{
"FlightKey": "Flight1",
"Journey": {
"Time": "18 H 25 M",
"Stops": 1
},
"SegmentReferences": "Segment1 Segment2"
},
{
"FlightKey": "Flight2",
"Journey": {
"Time": "20 H 40 M",
"Stops": 1
},
"SegmentReferences": "Segment3 Segment4"
}
]
},
"OriginDestinationList": {
"OriginDestination": [
{
"OriginDestinationKey": "OD1",
"DepartureCode": "MAA",
"ArrivalCode": "DXB",
"FlightReferences": "Flight1 Flight2"
}
]
},
"PriceClassList": {
"PriceClass": [
{
"PriceClassID": "PCR_1",
"Name": "",
"Code": "",
"Descriptions": {
"Description": []
}
}
]
},
"BaggageAllowanceList": {
"BaggageAllowance": [
{
"BaggageAllowanceID": "Bag1",
"BaggageCategory": "Checked",
"AllowanceDescription": {
"ApplicableParty": "Traveler",
"Description": "CHECKED ALLOWANCE"
},
"PieceAllowance": {
"ApplicableParty": "Traveler",
"TotalQuantity": "40",
"Unit": "kg"
}
}
]
},
"FopList": [
{
"CC": {
"Allowed": "Y",
"Types": {
"AX": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"VI": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
}
}
},
"DC": {
"Allowed": "Y",
"Types": {
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"VI": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
}
}
},
"CASH": {
"Allowed": "Y",
"Types": {}
},
"CHEQUE": {
"Allowed": "Y",
"Types": {}
},
"ACH": {
"Allowed": "Y",
"Types": {}
},
"PG": {
"Allowed": "Y",
"Types": {}
},
"FopKey": "FOP_282_282_712_0_ALL_PRI"
}
]
},
"MetaData": {}
}
}