Similar to AirShopping, this endpoint also allows you 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.
In addition to that, it allows you to search for alternate day’s rates. If you search for a specific date, the rates for that many days before and after will be displayed based on the value you specified in the Alternate Days section.
Schema
-
Name: Provide the name for the request. This is a String value.
-
ReferenceVersion: Provide the version number. This is a Numeric value.
-
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: This is an Array.
- EmailContact: Provide the email contact for the request. This is a String value.
-
-
OriginDestination: This is an Array. This is a required field. Provide the desired origin and destination.
-
Departure:
-
AirportCode: Provide the IATA Airport code for the request. Only three-letters codes are accepted. The value will be String.
-
Date: Departure date(YYYY-MM-DD) to be filled in for the request. Only (YYYY-MM-DD) format is accepted. The value will be Numeric.
-
-
Arrival:
- AirportCode: Provide the IATA Airport code for the request. Only three-letters codes are accepted. The value will be String.
-
-
Passenger: This is an Array.
Note: This is a required field. The passenger list must have atleast one adult. Infant object count should be less than or equal to adult count. Total pax should be less than or eqaul to 9.
-
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.
-
This is an optional field.
-
TripType: Provide your preferred trip type. Default value is ONEWAY. Valid values are
ONEWAY,ROUND,MULTI, andOPENJAW. The value will be String. This is a required field. -
CabinType: 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. The value will be String. This is a required field -
FareType: This is an Array. Provide your preferred Fare type. Default value is 70J:PUB. Valid values are
70J:PUB,749:PRI, and750:Both. This is a required field. -
AdditionalCabinType: This is an Array.Provide any additional cabin type. Valid values are
S: PREM ECONOMY,C: BUSINESS,D: PREMBUSINESS,F:FIRSTCLASS, andP: PREMFIRSTCLASS -
AlternateDays: Default value is 0. If the value is not 0, the alternate date request will be the same as the value. Valid values are
-3,-2,-1,0,1,2, and3. The value will be Numeric. -
NoOfStops: Provide the required number of stops. Valid values are
""and0. The value will be Numeric. -
NearByAirports: Provide if there is any airport present nearby. Defalut value is N. Valid values are
YandN. The value will be String. -
FreeBaggage: Provide if you want to request for free baggage. Default value is N. Valid values are
YandN. The value will be String. -
CountryPreference: Provide the Preferred country or Exclude country. The value will be String.
-
AirlinePreference: Provide the Preferred airlines or Exclude airlines. The value will be String.
-
StopPreference: Provide the Preferred stops or Exclude stops. The value will be String.
-
Currency: Provide to make a currency request. Default value is CAD. Valid values are
CAD,INR,USD, andSGD. The value will be String. This is a required field -
Penalties: This is an Object. Penalties are charges imposed by airlines on passengers for making changes to their flight itinerary or for cancelling their reservation. These penalties can vary depending on a number of factors, such as the type of ticket purchased, the time of cancellation or change request.
-
Usage: Although additional fees or penalties may apply. If the parameter is set to “N”, then changes may not be possible, and travellers may need to purchase a new ticket if they need to make changes to their travel plans.
-
Some common types of penalties that airlines may impose include
-
ZeroChangeFee
-
NoCancellationFee
-
Refundable
-
ReBookingPossible
-
-
ZeroChangeFee: The ZeroChangeFee parameter is used to specify if a flight itinerary can be changed without any additional fees. If this parameter is set to “Y”, then no change fees will apply. If it is set to “N”, then change fees will apply
-
NoCancellationFee: The NoCancellationFee parameter is used to indicate whether a flight itinerary can be cancelled without incurring any additional fees. If this parameter is set to “Y”, then no cancellation fees will apply. If it is set to “N”, then cancellation fees will apply.
-
Refundable: The Refundable parameter is used by airlines to specify if a flight itinerary can be refunded. If this parameter is set to “Y”, then the itinerary is fully refundable. If it is set to “N”, then the itinerary is non-refundable.
-
ReBookingPossible: The RebookingPossible parameter is to indicate whether it is possible to rebook a flight itinerary. If this parameter is set to “Y”, then the itinerary can be rebooked. If it is set to “N”, then the itinerary cannot be rebooked.
-
-
RbdPreference: The RbdPreference parameter is used to allow travellers to specify their preferred booking class or exclude specific booking classes. The parameter consists of a sub-parameter as RequireAllRbd, which can have a value of “Y” or “N”.
-
AlliancePreference: The AlliancePreference parameter allows you to specify the preference type for a specific airline alliance. This is a string value that requires you to mention the specific alliance code, such as “SA” for Star Alliance or “ST” for Sky Team. You can use this parameter to include or exclude the alliance preference type based on your requirements.
-
ConnectionTime: The ConnectionTime parameter is used to filter itineraries that include a connecting flight between the primary flight and the destination. This parameter specifies the minimum and maximum amount of time, in minutes, that you are willing to spend at the connecting airport. This works only when there is a stop. For example, you can set the Min value to 120 and the Max value to 240 to indicate that you want to spend between 2 to 4 hours at the connecting airport. The valid range for this parameter is between 1 hour to 24 hours.
-
DoubleOneWay: DoubleOneWay is a parameter is to indicate that a round-trip itinerary is constructed by combining two separate one-way flights rather than a round-trip ticket. If the DoubleOneWay parameter is set to “Y”, then the round-trip itinerary is constructed by booking two separate one-way flights, with one outbound flight and one return flight. This can sometimes result in a lower fare than a round-trip ticket, as airlines may offer different pricing for one-way flights.
Request URL
curl --location --request POST 'https://newapi.tltid.com/AirShoppingAltDate' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
Request Body Sample
{
"AirShoppingRQ": {
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "kathir",
"IATA_Number": "",
"AgencyID": "",
"Contacts": {
"Contact": [
{
"EmailContact": "pst@claritytts.com"
}
]
}
}
}
},
"CoreQuery": {
"OriginDestinations": {
"OriginDestination": [
{
"Departure": {
"AirportCode": "MAA",
"Date": "2023-03-24",
"DepartureTime": {
"From": "",
"To": ""
},
"NoOfMiles": ""
},
"Arrival": {
"AirportCode": "DXB",
"NoOfMiles": ""
}
}
]
}
},
"DataLists": {
"PassengerList": {
"Passenger": [
{
"PassengerID": "T1",
"PTC": "ADT"
}
]
}
},
"Preference": {
"TripType": "Oneway",
"Cabin": "Y",
"AlternateDays": "2",
"DirectFlight": "",
"Refundable": "",
"NearByAirports": "",
"FreeBaggage": "N",
"AlliancePreference": {
"PreferedAlliance": [],
"ExcludeAlliance": []
},
"RbdPreference": {
"RequireAllRbd": "N",
"PreferedRbds": [],
"ExcludeRbds": []
},
"NoOfStops": [],
"ConnectionTime": {
"Min": "",
"Max": ""
},
"FareType": [
"70J",
"749"
],
"Penalties": {
"ZeroChangeFee": "N",
"NoCancellationFee": "N",
"Refundable": "N",
"RebookingPossible": "N"
},
"AirlinePreference": {
"PreferedAirlines": [],
"ExcludeAirlines": []
},
"StopPreference": {
"PreferedStops": [],
"ExcludeStops": []
},
"CountryPreference": {
"ExcludeCountry": []
},
"SourceFrom": [
"ALL"
],
"DoubleOneWay": "N"
},
"MetaData": {
"TraceId": "161777799749"
}
}
}
Response Sample
{
"AirShoppingRS": {
"Document": {
"Name": "API GATEWAY",
"ReferenceVersion": "1.2"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "Mahesh Tours And Travels",
"IATA_Number": "",
"AgencyID": "Mahesh Tours And Travels",
"Contacts": {
"Contact": [
{
"EmailContact": "pst@claritytts.com"
}
]
}
}
}
},
"ShoppingResponseId": "1678878251386340937",
"Success": {},
"OffersGroup": {
"AirlineOffers": [
{
"AirlineOfferSnapshot": {
"PassengerQuantity": 1,
"MatchedOfferQuantity": 1,
"Lowest": {
"BookingCurrencyPrice": 132.46,
"EquivCurrencyPrice": 167.59
},
"Highest": {
"BookingCurrencyPrice": 132.46,
"EquivCurrencyPrice": 167.59
}
},
"Offer": [
{
"OfferID": "77061711678878252031933557",
"Owner": "AI",
"OwnerName": "Air India",
"TicketType": "Single",
"IsBrandedFare": "N",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "true",
"AllowHold": "Y",
"TimeLimits": {
"OfferExpirationDateTime": "2023-03-15T18:34:12",
"PaymentExpirationDateTime": "2023-03-16 08:00:00"
},
"PassportRequired": "N",
"BookingCurrencyCode": "USD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "AIF",
"BookingCurrencyPrice": 4.08,
"EquivCurrencyPrice": 5.16
},
"TotalPrice": {
"BookingCurrencyPrice": 132.46,
"EquivCurrencyPrice": 167.59
},
"BasePrice": {
"BookingCurrencyPrice": 106,
"EquivCurrencyPrice": 134.11
},
"TaxPrice": {
"BookingCurrencyPrice": 26.46,
"EquivCurrencyPrice": 33.48
},
"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": 146,
"EquivCurrencyPrice": 184.72
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
},
"CancelationFee": {
"Before": {
"BookingCurrencyPrice": 170,
"EquivCurrencyPrice": 215.08
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
}
},
"OfferItem": [
{
"OfferItemID": "OFFERITEMID1",
"Refundable": "true",
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 132.46,
"EquivCurrencyPrice": 167.59
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight1"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 132.46,
"EquivCurrencyPrice": 167.59
},
"BaseAmount": {
"BookingCurrencyPrice": 106,
"EquivCurrencyPrice": 134.11
},
"TaxAmount": {
"BookingCurrencyPrice": 26.46,
"EquivCurrencyPrice": 33.48
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"BookingFee": {
"BookingCurrencyPrice": 4.08,
"EquivCurrencyPrice": 4.08
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Taxes": [
{
"TaxCode": "YRF",
"BookingCurrencyPrice": 1.2,
"EquivCurrencyPrice": 1.52
},
{
"TaxCode": "ZR",
"BookingCurrencyPrice": 1.4,
"EquivCurrencyPrice": 1.77
},
{
"TaxCode": "IN",
"BookingCurrencyPrice": 4.3,
"EquivCurrencyPrice": 5.44
},
{
"TaxCode": "K38",
"BookingCurrencyPrice": 5.3,
"EquivCurrencyPrice": 6.71
},
{
"TaxCode": "K3B",
"BookingCurrencyPrice": 0.1,
"EquivCurrencyPrice": 0.13
},
{
"TaxCode": "P2",
"BookingCurrencyPrice": 14.16,
"EquivCurrencyPrice": 17.92
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment1",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1",
"Code": "SLOWMAAE"
},
"RBD": "S",
"CabinType": "Y",
"SeatLeft": "4"
}
}
]
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment1",
"PassengerRefs": "T1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "77061711678878252031933557",
"MultipleFop": "Y",
"MaxCardsPerPax": 2,
"MaxCardsPerPaxInMFOP": 1
}
],
"BookingToEquivExRate": 1.2652,
"FopRef": "FOP_196_0_617_0_ALL_PUB"
}
]
}
]
},
"DataLists": {
"PassengerList": {
"Passengers": [
{
"PassengerID": "T1",
"PTC": "ADT"
}
]
},
"DisclosureList": {
"Disclosures": []
},
"FareList": {
"FareGroup": [
{
"FareGroupRef": "FG_1",
"FareCode": "70J",
"FareBasisCode": "SLOWMAAE"
}
]
},
"FlightSegmentList": {
"FlightSegment": [
{
"SegmentKey": "Segment1",
"Departure": {
"AirportCode": "MAA",
"Date": "2023-03-22",
"Time": "19:05:00",
"AirportName": "Chennai International Airport",
"Terminal": {
"Name": "4"
}
},
"Arrival": {
"AirportCode": "DXB",
"Date": "2023-03-22",
"Time": "22:00:00",
"AirportName": "Dubai International Airport",
"Terminal": {
"Name": "1"
}
},
"MarketingCarrier": {
"AirlineID": "AI",
"Name": "Air India",
"FlightNumber": "905"
},
"OperatingCarrier": {
"AirlineID": "AI",
"Name": "Air India",
"FlightNumber": "905"
},
"Equipment": {
"AircraftCode": "321",
"Name": "Airbus A321-100/200"
},
"Code": {
"MarriageGroup": "O"
},
"FlightDetail": {
"FlightDuration": {
"Value": "4 H 25 M"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": 1824
},
"BrandId": ""
}
]
},
"FlightList": {
"Flight": [
{
"FlightKey": "Flight1",
"Journey": {
"Time": "4 H 25 M",
"Stops": 0
},
"SegmentReferences": "Segment1"
}
]
},
"OriginDestinationList": {
"OriginDestination": [
{
"OriginDestinationKey": "OD1",
"DepartureCode": "MAA",
"ArrivalCode": "DXB",
"FlightReferences": "Flight1"
}
]
},
"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": "30",
"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
},
"JC": {
"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
},
"RU": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
}
}
},
"CASH": {
"Allowed": "N",
"Types": {}
},
"CHEQUE": {
"Allowed": "Y",
"Types": {}
},
"ACH": {
"Allowed": "Y",
"Types": {}
},
"PG": {
"Allowed": "Y",
"Types": {}
},
"FopKey": "FOP_196_0_617_0_ALL_PUB"
}
]
},
"MetaData": {}
}
}