The “AirReservationStatus” feature allows users to retrieve the current status of a Passenger Name Record (PNR), which could include information about whether the PNR is confirmed, modified, rescheduled, cancelled, or if there have been any other changes. The PNR status can be accessed using the “PnrStatus” key in the offline data that has been stored. Here is an elaboration of the possible status values:
CONFIRMED : This status confirms that the PNR has been successfully ticketed and the reservation is confirmed.
PENDING : This indicates that the booking process for the PNR is still Done and has not been ticketed yet.
MODIFIED : This status signifies that changes have been made to the PNR after the initial booking, such as modifications to the travel dates, passenger details, or other aspects of the reservation.
CANCELLED : This status indicates that the PNR has been cancelled, and the reservation is no longer valid. This could be due to a cancellation request from the passenger or any other relevant reason.
SCHEDULE CHANGED : This status refers to changes made to the PNR due to operational requirements or schedule changes. It indicates that there have been modifications to the flight schedule, such as changes in departure or arrival times.
FAILED: This means that the reservation could not be confirmed, and the ticket was not issued
In the context of schedule changes, the parameter ScheduleChangeIndicator is set to “true.” This indicates that there have been schedule changes within the PNR. These changes could involve alterations to the flight timings, departure or arrival dates, or any other schedule-related updates. By using this indicator, users will receive information about the new segments resulting from the schedule changes. If interested in accepting these new segments,proceed with the necessary steps.
By retrieving the PNR status through the “AirReservationStatus” feature and examining the value in the “PnrStatus” key, users can determine the current state of the reservation, whether it is confirmed, modified, rescheduled, cancelled, or if any other relevant changes have occurred. This information can be useful for passengers, travel agents, or any other individuals involved in managing airline reservations.
Note: GDS-Global Distribution System.
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. This is a String value.
-
Contacts: This is an Array.
- EmailContact: Provide the email contact for the request. This is a String value.
-
-
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.
It is multiple when it’s a one-way offer.
Request URL
curl --location --request POST 'https://newapi.tltid.com/AirOrderCreateV2' \
--header 'x-api-key: <your key here>' \
Request Body Sample
{
"OrderStatusRQ": {
"Document": {
"Name": "Venkat B2B portal",
"referenceversion": "1.0"
},
"party": {
"sender": {
"travelagencysender": {
"name": "mrst",
"iata_number": "",
"agencyid": "",
"contacts": {
"contact": [
{
"emailcontact": "test@email.com"
}
]
}
}
}
},
"Query": {
"OrderID": "OCOW1HCO",
"GdsBookingReference": "3JEIGF"
}
}
}
Response Sample
{
"OrderViewRS": {
"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": "rammrkv@gmail.com"
}
]
}
}
}
},
"ShoppingResponseId": "1688454488078509407",
"Success": {},
"Payments": {
"Payment": [
{
"Type": "CHECK",
"Amount": "978.15",
"ChequeNumber": "65758658"
}
]
},
"Order": [
{
"OrderID": "OCOW1HCO",
"GdsBookingReference": "3JEIGF",
"PnrStatus": "CONFIRMED",
"ScheduleChangeIndicator": false,
"NeedToTicket": "N",
"OfferID": "78062611688454497841612455",
"Owner": "AF",
"OwnerName": "Air France",
"IsBrandedFare": "N",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "",
"TimeLimits": {
"OfferExpirationDateTime": "2023-07-04T18:20:54"
},
"BookingCurrencyCode": "CAD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "",
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"TotalPrice": {
"BookingCurrencyPrice": "978.1500",
"EquivCurrencyPrice": 978.15
},
"BasePrice": {
"BookingCurrencyPrice": "550.1900",
"EquivCurrencyPrice": 550.19
},
"TaxPrice": {
"BookingCurrencyPrice": "427.9600",
"EquivCurrencyPrice": 427.96
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": "0.0000",
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": "0.0000",
"EquivCurrencyPrice": 0
}
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": "0.0000",
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": "0.0000",
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": "0.0000",
"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": "false",
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 978.1500000000001,
"EquivCurrencyPrice": 978.1500000000001
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight1"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 978.1500000000001,
"EquivCurrencyPrice": 978.1500000000001
},
"BaseAmount": {
"BookingCurrencyPrice": 550.19,
"EquivCurrencyPrice": 550.19
},
"TaxAmount": {
"BookingCurrencyPrice": 427.96,
"EquivCurrencyPrice": 427.96
},
"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": "CA",
"BookingCurrencyPrice": 25.91,
"EquivCurrencyPrice": 25.91
},
{
"TaxCode": "YQ",
"BookingCurrencyPrice": 25,
"EquivCurrencyPrice": 25
},
{
"TaxCode": "YR",
"BookingCurrencyPrice": 337.5,
"EquivCurrencyPrice": 337.5
},
{
"TaxCode": "RC",
"BookingCurrencyPrice": 4.55,
"EquivCurrencyPrice": 4.55
},
{
"TaxCode": "SQ",
"BookingCurrencyPrice": 35,
"EquivCurrencyPrice": 35
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment1",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1",
"Code": "NHX79NBL"
},
"RBD": "N",
"CabinType": "Y",
"SeatLeft": "9"
}
}
]
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment1",
"PassengerRefs": "ADT1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "78062611688454497841612455",
"MultipleFop": "N",
"MaxCardsPerPax": 0,
"MaxCardsPerPaxInMFOP": 0
}
],
"BookingToEquivExRate": "1.0000",
"FopRef": "FOP_196_0_626_0_ALL_PUB"
}
],
"DataLists": {
"PassengerList": {
"Passengers": [
{
"attributes": {
"PassengerID": "ADT1"
},
"PassengerID": "ADT1",
"PTC": "ADT",
"BirthDate": "1998-07-22",
"NameTitle": "Mr",
"FirstName": "Ram",
"MiddleName": "",
"LastName": "Kumar",
"Gender": "Male",
"TravelDocument": {
"DocumentNumber": "",
"ExpiryDate": "0000-00-00",
"IssuingCountry": "",
"DocumentType": "P"
},
"Preference": {
"WheelChairPreference": {
"Reason": ""
},
"SeatPreference": ""
},
"LoyaltyProgramAccount": [],
"ContactInfoRef": "CTC1"
}
]
},
"DisclosureList": {
"Disclosures": []
},
"contactEmail": [],
"contactNumber": [],
"ContactAddress": [],
"FareList": {
"FareGroup": [
{
"FareGroupRef": "FG_1",
"FareCode": "70J",
"FareBasisCode": "NHX79NBL"
}
]
},
"FlightSegmentList": {
"FlightSegment": [
{
"SegmentKey": "Segment1",
"Departure": {
"AirportCode": "YYZ",
"Date": "2023-07-13",
"Time": "15:55:00",
"AirportName": "Lester B. Pearson International Airport",
"Terminal": {
"Name": "3"
}
},
"Arrival": {
"AirportCode": "CDG",
"Date": "2023-07-14",
"Time": "05:30:00",
"AirportName": "Charles de Gaulle International Airport",
"Terminal": {
"Name": "2E"
}
},
"MarketingCarrier": {
"AirlineID": "AF",
"Name": "Air France",
"FlightNumber": "357"
},
"OperatingCarrier": {
"AirlineID": null,
"Name": null,
"FlightNumber": "357"
},
"Equipment": {
"AircraftCode": "789",
"Name": "789"
},
"Code": {
"MarriageGroup": ""
},
"FlightDetail": {
"FlightDuration": {
"Value": "7 Hrs 35 Min"
},
"Stops": {
"Value": 0
},
"InterMediate": [],
"AirMilesFlown": ""
},
"BrandId": ""
}
]
},
"FlightList": {
"Flight": [
{
"FlightKey": "Flight1",
"Journey": {
"Stops": 0
},
"SegmentReferences": "Segment1"
}
]
},
"OriginDestinationList": {
"OriginDestination": [
{
"OriginDestinationKey": "OD1",
"DepartureCode": "YYZ",
"ArrivalCode": "CDG",
"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": "0",
"Unit": "Peices"
}
}
]
},
"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": "Y",
"Types": []
},
"CHEQUE": {
"Allowed": "Y",
"Types": []
},
"ACH": {
"Allowed": "Y",
"Types": []
},
"PG": {
"Allowed": "Y",
"Types": []
},
"FopKey": "FOP_196_0_626_0_ALL_PUB"
}
]
},
"TicketDocInfos": {
"TicketDocInfo": [
{
"TicketDocument": {
"TicketDocNbr": "0571116638065",
"Type": "TKT"
},
"PassengerReference": "ADT1",
"GdsBookingReference": "3JEIGF"
}
]
},
"MetaData": {}
}
}