Passengers may be able to add or modify their baggage allowance after booking their flight.This endpoint can be used to book or modify the ancillaries after the initial ticket purchase by specifying various parameters, such as Offer ID, Shopping Response ID, Offer Response ID, Seat Response ID, Itinerary ID, and a few more parameters.
When a passenger requests a paid ancillary service, the airline may issue an EMD to facilitate the payment and record the transaction. The EMD contains information such as the passenger’s name, the service requested, the cost, and the validity period.
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.
-
The Shopping Response ID is a unique identifier that is generated when a customer performs a search for flights and receives a list of available options.
This is the required field and the value will be Numeric.
-
OrderID: This is the unique identifier that is typically provided by the airline at the time of booking. This is the required field, and the value will be String..
-
GdsBookingReference: This is the code that is used by GDS to identify the booking. The GDS booking references are typically provided by the airlines at the time of booking. This is the required field, and the value will be the String.
-
OptinalServiceId: An OptionalServiceID is a unique identifier that is used to specify a particular optional service that is associated with a passenger’s itinerary. Optional services may include things like baggage fees, in-flight meals.
-
PassengerID : PassengerID is a unique identifier used to identify a specific passenger on a flight. This identifier is typically assigned by the airline and may be used throughout the passenger’s journey to track their itinerary, ticket information, and other relevant data.
-
SeatId: An OptionalServiceID is a unique identifier that is used to specify a particular optional service that is associated with a passenger’s itinerary. When a passenger books a flight, they may be able to choose their seat or may be assigned a seat by the airline. The SeatID is used to identify the specific seat that has been assigned to the passenger.
-
PassengerID : PassengerID is a unique identifier used to identify a specific passenger on a flight. This identifier is typically assigned by the airline and may be used throughout the passenger’s journey to track their itinerary, ticket information, and other relevant data.
Book.
This is an Array
-
Type: This is a required field. Provide the payment type. Valid values are
CardandCheque. -
Amount: This is a required field. Provide the amount. This is a Numeric value.
-
Method:
- CardCode: Provide the card code. This is a String value.
For Card Type CC possible Card Codes are AX, DC, DI, DUS, JC, MA, MC, VI.
For Card Type DC possible Card Codes are MC, RU, and VI.
-
CardNumber: Provide the card number. This is a String value.
-
SeriesCode: Provide the card number. This is a String value.
-
CardHolderName: Provide the card holder’s name. This is a String value.
-
EffectiveExpireDate: Provide the Effective date and Expiration date. This is a String value.
-
Payer:
- ContactInfoRefs:
-
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 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: Valid values are
ADT,CHD, andINF. This is a String value. -
OnflyMarkup: This is an optional field. This is a String value.
-
OnflyDiscount: This is an optional field. This is a String value.
-
OnFlyPenalty: This is an optional field. This is a String value.
-
BirthDate: Provide the birth date. This is a Numeric value.
-
NameTitle: Provide the title for the given name. This is a String value. Valid values are,
- ADT/Male:
Mr - ADT/Female:
MrsandMs - CHD/Male:
Mstr - CHD/Female:
Miss - INF/Male:
Mstr - INF/Female:
Miss
- ADT/Male:
-
FirstName: Provide the first name. This is a String value.
-
MiddleName: Provide the middle name. This is a String value.
-
LastName: Provide the last name. This is a String value. .
-
Gender: Provide the gender of the passenger. Valid values are
MaleandFemale. This is a String value. -
ContactInfoRef: Provide the contact information details.
-
This is an Array. This is a required field. Provide all the contact information here.
-
ContactID: Provide the contact ID.
-
AgencyName: Provide the agency name.
-
EmailAddress: Provide the email address.
-
Phone:
-
CountryCode: Provide the country code.
-
AreaCode: Provide the area code.
-
PhoneNumber: Provide the phone number.
-
-
Mobile:
-
CountryCode: Provide the country code.
-
MobileNumber: Provide the mobile number.
-
-
Address:
- Street: This is an Array. Provide the street details.
- CityName: Provide the city name.
- StateProv: Provide the state or province name.
- PostalCode: Provide the postal code.
- CountryCode: Provide the country code.
-
PassengerContact: Provide the contact details.
-
EmailAddress: Provide your email ID. This is a String value.
-
Phone:
-
CountryCode: Provide the country code. This is a String value.
-
AreaCode: Provide the area code. This is a String value.
-
PhoneNumber: Provide the phone number. This is a Numeric value.
-
-
Request URL
curl --location --request POST 'https://newapi.tltid.com/AirOrderChange' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
Request Body Sample
{
"OrderChangeRQ": {
"Document": {
"Name": "Wintlt NDC GATEWAY",
"ReferenceVersion": "1.0"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "Skyroute B2B Portal",
"IATA_Number": "1111111111",
"AgencyID": "Skyroute B2B Portal",
"Contacts": {
"Contact": [
{
"EmailContact": "pst@claritytts.com"
}
]
}
}
}
},
"ShoppingResponseId": "1679299656823220978",
"SeatResponseId": "1679299875388811691",
"ServiceListResponseId": "1679299905760281451",
"Query": {
"OrderID": "NREFQIDC",
"GdsBookingReference": [
"OUFSVJ"
],
"OrderServicing": {
"AcceptOffer": {
"ServiceList": [
{
"OptinalServiceId": "1679299908086613481",
"PassengerID": "ADT1"
}
],
"Seat": [
{
"SeatId": "1679299879190691941",
"PassengerID": "ADT1"
}
]
}
}
},
"BookingType": "BOOK",
"Payments": {
"Payment": [
{
"Type": "CHECK",
"Amount": 99.44,
"ChequeNumber": "323325",
"OnflyMarkup": "0.00",
"OnflyDiscount": "0.00",
"PromoCode": "",
"PromoDiscount": "",
"onFlyPenalty": ""
}
]
},
"DataLists": {
"PassengerList": {
"Passenger": [
{
"PassengerID": "ADT1",
"PTC": "ADT",
"BirthDate": "1996-03-15",
"NameTitle": "Mr",
"FirstName": "LEBRON",
"MiddleName": "",
"LastName": "JAMES",
"Gender": "Male",
"ContactInfoRef": "CTC1"
}
]
},
"ContactList": {
"ContactInformation": [
{
"ContactID": "CTC1",
"AgencyName": "kathir",
"EmailAddress": "kathir@gmail.com",
"Phone": {
"ContryCode": "+91",
"AreaCode": "",
"PhoneNumber": "9854785465"
},
"Mobile": {
"ContryCode": "+91",
"MobileNumber": "9854785465"
},
"Address": {
"Street": [
"testing address1",
null
],
"CityName": "chennai",
"StateProv": "AX",
"PostalCode": "123465",
"CountryCode": "CA"
},
"PassengerContact": {
"EmailAddress": "mosris@gmail.com",
"Phone": {
"ContryCode": "",
"AreaCode": "",
"PhoneNumber": "9856325698"
}
}
}
]
}
}
}
}
Response Sample
{
"OrderViewRS": {
"Document": {
"Name": "API GATEWAY",
"ReferenceVersion": "1.2"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "Lucky Travels",
"IATA_Number": "",
"AgencyID": "",
"Contacts": {
"Contact": [
{
"EmailContact": "pst@claritytts.com"
}
]
}
}
}
},
"ShoppingResponseId": "1679299656823220978",
"Success": {},
"Order": [
{
"OrderID": "NREFQIDC",
"GdsBookingReference": "OUFSVJ",
"NeedToTicket": "N",
"OptionalServiceStatus": "FAILED",
"SeatSelectionStatus": "SUCCESS",
"OfferID": "137211721101679299662551142435",
"Owner": "WS",
"OwnerName": "Westjet",
"IsBrandedFare": "Y",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "",
"TimeLimits": {
"OfferExpirationDateTime": "2023-03-20T10:17:37"
},
"BookingCurrencyCode": "CAD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "",
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"TotalPrice": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
},
"BasePrice": {
"BookingCurrencyPrice": 195,
"EquivCurrencyPrice": 195
},
"TaxPrice": {
"BookingCurrencyPrice": 37.35,
"EquivCurrencyPrice": 37.35
},
"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
}
},
"AgentMarkupInfo": {
"OnflyMarkup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"OnflyDiscount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"OnflyHst": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"PromoDiscount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0,
"PromoCode": ""
}
},
"Penalty": {
"ChangeFee": {
"Before": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
},
"CancelationFee": {
"Before": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
}
},
"PaxSeatInfo": [],
"OfferItem": [
{
"OfferItemID": "OFFERITEMID1",
"Refundable": "0",
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight1"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
},
"BaseAmount": {
"BookingCurrencyPrice": 195,
"EquivCurrencyPrice": 195
},
"TaxAmount": {
"BookingCurrencyPrice": 37.35,
"EquivCurrencyPrice": 37.35
},
"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": "RC",
"BookingCurrencyPrice": 15.23,
"EquivCurrencyPrice": 15.23
},
{
"TaxCode": "SQ",
"BookingCurrencyPrice": 15,
"EquivCurrencyPrice": 15
},
{
"TaxCode": "CA",
"BookingCurrencyPrice": 7.12,
"EquivCurrencyPrice": 7.12
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment1",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1",
"Code": "ACUD0ZBJ"
},
"RBD": "A",
"CabinType": "Y",
"SeatLeft": "9"
}
}
]
},
{
"OfferItemID": "Seat-OfferItem-1",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment1",
"SelectedSeat": {
"Seat": {
"Row": 4,
"Column": "A"
}
}
},
"Price": {
"Base": {
"BookingCurrencyPrice": 88,
"EquivCurrencyPrice": 88
},
"Tax": {
"BookingCurrencyPrice": 11.44,
"EquivCurrencyPrice": 11.44
},
"Total": {
"BookingCurrencyPrice": 99.44,
"EquivCurrencyPrice": 99.44
}
}
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment1",
"PassengerRefs": "ADT1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "137211721101679299662551142435",
"MultipleFop": "N",
"MaxCardsPerPax": 0,
"MaxCardsPerPaxInMFOP": 0
}
],
"BookingToEquivExRate": 1,
"FopRef": "FOP_429_0_1172_0_ALL_PUB"
}
],
"DataLists": {
"PassengerList": {
"Passengers": [
{
"attributes": {
"PassengerID": "ADT1"
},
"PassengerID": "ADT1",
"PTC": "ADT",
"BirthDate": "1996-03-15",
"NameTitle": "Mr",
"FirstName": "LEBRON",
"MiddleName": "",
"LastName": "JAMES",
"Gender": "Male",
"TravelDocument": {
"DocumentNumber": "",
"ExpiryDate": "2001-01-01",
"IssuingCountry": "",
"DocumentType": "P"
},
"Preference": {
"WheelChairPreference": {
"Reason": ""
},
"SeatPreference": "any"
},
"LoyaltyProgramAccount": [],
"ContactInfoRef": "CTC1"
}
]
},
"DisclosureList": {
"Disclosures": []
},
"contactEmail": [
"kathir@gmail.com"
],
"contactNumber": [
"9854785465"
],
"ContactAddress": [
"testing address1"
],
"FareList": {
"FareGroup": [
{
"FareGroupRef": "FG_1",
"FareCode": "70J",
"FareBasisCode": "ACUD0ZBJ"
}
]
},
"FlightSegmentList": {
"FlightSegment": [
{
"SegmentKey": "Segment1",
"Departure": {
"AirportCode": "YKF",
"Date": "2023-05-26",
"Time": "22:00:00",
"AirportName": "Waterloo Airport",
"Terminal": {
"Name": ""
}
},
"Arrival": {
"AirportCode": "YVR",
"Date": "2023-05-26",
"Time": "22:45:00",
"AirportName": "Vancouver International Airport",
"Terminal": {
"Name": ""
}
},
"MarketingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "8503"
},
"OperatingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "8503"
},
"Equipment": {
"AircraftCode": "73H",
"Name": "Boeing 737-800 (winglets) pax"
},
"Code": {
"MarriageGroup": ""
},
"FlightDetail": {
"FlightDuration": {
"Value": "3 Hrs 45 Min"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": "2054"
},
"BrandId": "BASIC"
}
]
},
"FlightList": {
"Flight": [
{
"FlightKey": "Flight1",
"Journey": {
"Time": "3 H 45 M",
"Stops": 0
},
"SegmentReferences": "Segment1"
}
]
},
"OriginDestinationList": {
"OriginDestination": [
{
"OriginDestinationKey": "OD1",
"DepartureCode": "YKF",
"ArrivalCode": "YVR",
"FlightReferences": "Flight1"
}
]
},
"PriceClassList": {
"PriceClass": [
{
"PriceClassID": "PCR_1",
"Name": "Basic",
"Code": "Basic",
"Descriptions": {
"Description": []
}
}
]
},
"BaggageAllowanceList": {
"BaggageAllowance": [
{
"BaggageAllowanceID": "Bag1",
"BaggageCategory": "Checked",
"AllowanceDescription": {
"ApplicableParty": "Traveler",
"Description": "CHECKED ALLOWANCE"
},
"PieceAllowance": {
"ApplicableParty": "Traveler",
"TotalQuantity": "0",
"Unit": "kg"
}
}
]
},
"FopList": [
{
"CC": {
"Allowed": "Y",
"Types": {
"AX": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"VI": {
"F": {
"BookingCurrencyPrice": "0",
"EquivCurrencyPrice": "0"
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
}
}
},
"DC": {
"Allowed": "Y",
"Types": {
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"VI": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"RU": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0,
"Charges": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
}
}
},
"CASH": {
"Allowed": "N",
"Types": {}
},
"CHEQUE": {
"Allowed": "Y",
"Types": {}
},
"ACH": {
"Allowed": "Y",
"Types": {}
},
"PG": {
"Allowed": "Y",
"Types": {}
},
"FopKey": "FOP_429_0_1172_0_ALL_PUB"
}
]
},
"TicketDocInfos": {
"TicketDocInfo": [
{
"TicketDocument": {
"TicketDocNbr": "8381609825639",
"Type": "TKT"
},
"PassengerReference": "ADT1",
"GdsBookingReference": "OUFSVJ"
}
]
},
"MetaData": {}
}
}