AirDocRetreive

This is an after-booking service. You need the OrderID and GDS Booking Reference to retrieve it.Once you have provided the OrderID and GDS Booking Reference as parameters to the AirDocRetrieve endpoint, the API will attempt to retrieve the ticket document details.

If the retrieval is successful, the API will return the ticket document details, which may include information such as the passenger’s name, flight details, fare information, and other relevant details.

It’s important to note that the AirDocRetrieve endpoint is a read-only service and cannot be used to make changes to the ticket document or booking .

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.

  • 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.


Request URL

curl --location --request POST 'https://newapi.tltid.com/AirDocRetreive' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \

Request Body Sample

{
    "AirDocRetreiveRQ": {
        "Document": {
            "Name": "Skyroute B2B Portal",
            "ReferenceVersion": "1.0"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "Skyroute B2B",
                    "IATA_Number": "1111111111",
                    "AgencyID": "1111111111",
                    "Contacts": {
                        "Contact": [
                            {
                                "emailcontact": "pst@claritytts.com"
                            }
                        ]
                    }
                }
            }
        },
        "Query": {
            "OrderID": "M4YAA56Z",
            "GdsBookingReference": [
                "OUUAYC"
            ]
        }
    }
}

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": "1678628591743215863",
        "Success": {},
        "Order": [
            {
                "OrderID": "M4YAA56Z",
                "GdsBookingReference": "OUUAYC",
                "NeedToTicket": "N",
                "OfferID": "137211723101678628593468465527",
                "Owner": "WS",
                "OwnerName": "Westjet",
                "IsBrandedFare": "Y",
                "BrandedFareOptions": [],
                "CabinOptions": [],
                "IsAdditionalCabinType": "N",
                "Eticket": "",
                "TimeLimits": {
                    "OfferExpirationDateTime": "2023-03-13T07:29:03"
                },
                "BookingCurrencyCode": "CAD",
                "EquivCurrencyCode": "CAD",
                "HstPercentage": "",
                "RewardSettings": {
                    "RewardAvailable": "N",
                    "PointTypes": [],
                    "PointValues": {}
                },
                "BookingFeeInfo": {
                    "FeeType": "",
                    "BookingCurrencyPrice": 0,
                    "EquivCurrencyPrice": 0
                },
                "TotalPrice": {
                    "BookingCurrencyPrice": 248.5,
                    "EquivCurrencyPrice": 248.5
                },
                "BasePrice": {
                    "BookingCurrencyPrice": 189.3,
                    "EquivCurrencyPrice": 189.3
                },
                "TaxPrice": {
                    "BookingCurrencyPrice": 59.2,
                    "EquivCurrencyPrice": 59.2
                },
                "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": 175,
                            "EquivCurrencyPrice": 175
                        },
                        "After": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        }
                    },
                    "CancelationFee": {
                        "Before": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        },
                        "After": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        }
                    }
                },
                "PaxSeatInfo": [],
                "OfferItem": [
                    {
                        "OfferItemID": "OFFERITEMID1",
                        "Refundable": "1",
                        "PassengerType": "ADT",
                        "PassengerQuantity": 1,
                        "TotalPriceDetail": {
                            "TotalAmount": {
                                "BookingCurrencyPrice": 248.5,
                                "EquivCurrencyPrice": 248.5
                            }
                        },
                        "Service": [
                            {
                                "ServiceID": "SV1",
                                "PassengerRefs": "ADT1",
                                "FlightRefs": "Flight1"
                            }
                        ],
                        "FareDetail": {
                            "PassengerRefs": "ADT1",
                            "Price": {
                                "TotalAmount": {
                                    "BookingCurrencyPrice": 248.5,
                                    "EquivCurrencyPrice": 248.5
                                },
                                "BaseAmount": {
                                    "BookingCurrencyPrice": 189.3,
                                    "EquivCurrencyPrice": 189.3
                                },
                                "TaxAmount": {
                                    "BookingCurrencyPrice": 59.2,
                                    "EquivCurrencyPrice": 59.2
                                },
                                "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": 17.08,
                                        "EquivCurrencyPrice": 17.08
                                    },
                                    {
                                        "TaxCode": "SQ",
                                        "BookingCurrencyPrice": 35,
                                        "EquivCurrencyPrice": 35
                                    },
                                    {
                                        "TaxCode": "CA",
                                        "BookingCurrencyPrice": 7.12,
                                        "EquivCurrencyPrice": 7.12
                                    }
                                ]
                            }
                        },
                        "FareComponent": [
                            {
                                "PriceClassRef": "PCR_1",
                                "SegmentRefs": "Segment1",
                                "FareBasis": {
                                    "FareBasisCode": {
                                        "Refs": "FG_1",
                                        "Code": "ACUD0ZBI/CLO"
                                    },
                                    "RBD": "A",
                                    "CabinType": "Y",
                                    "SeatLeft": "9"
                                }
                            }
                        ]
                    }
                ],
                "BaggageAllowance": [
                    {
                        "SegmentRefs": "Segment1",
                        "PassengerRefs": "ADT1",
                        "BaggageAllowanceRef": "Bag1"
                    }
                ],
                "SplitPaymentInfo": [
                    {
                        "AirItineraryId": "137211723101678628593468465527",
                        "MultipleFop": "N",
                        "MaxCardsPerPax": 0,
                        "MaxCardsPerPaxInMFOP": 0
                    }
                ],
                "BookingToEquivExRate": 1,
                "FopRef": "FOP_429_0_1172_0_ALL_ITX"
            }
        ],
        "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": "750",
                        "FareBasisCode": "ACUD0ZBI/CLO"
                    }
                ]
            },
            "FlightSegmentList": {
                "FlightSegment": [
                    {
                        "SegmentKey": "Segment1",
                        "Departure": {
                            "AirportCode": "YYZ",
                            "Date": "2023-06-15",
                            "Time": "06:30:00",
                            "AirportName": "Lester B. Pearson International Airport",
                            "Terminal": {
                                "Name": "3"
                            }
                        },
                        "Arrival": {
                            "AirportCode": "YVR",
                            "Date": "2023-06-15",
                            "Time": "08:35:00",
                            "AirportName": "Vancouver International Airport",
                            "Terminal": {
                                "Name": "M"
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "WS",
                            "Name": "Westjet",
                            "FlightNumber": "701"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "WS",
                            "Name": "Westjet",
                            "FlightNumber": "701"
                        },
                        "Equipment": {
                            "AircraftCode": "73W",
                            "Name": "Boeing 737-700 (winglets) pax"
                        },
                        "Code": {
                            "MarriageGroup": ""
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "5 Hrs 5 Min"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": "2085"
                        },
                        "BrandId": "BASIC"
                    }
                ]
            },
            "FlightList": {
                "Flight": [
                    {
                        "FlightKey": "Flight1",
                        "Journey": {
                            "Time": "5 H 5 M",
                            "Stops": 0
                        },
                        "SegmentReferences": "Segment1"
                    }
                ]
            },
            "OriginDestinationList": {
                "OriginDestination": [
                    {
                        "OriginDestinationKey": "OD1",
                        "DepartureCode": "YYZ",
                        "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_ITX"
                }
            ]
        },
        "TicketDocInfos": {
            "TicketDocInfo": [
                {
                    "TicketDocument": {
                        "TicketDocNbr": "8381609819719",
                        "Type": "TKT"
                    },
                    "PassengerReference": "ADT1",
                    "GdsBookingReference": "OUUAYC"
                }
            ]
        },
        "MetaData": {}
    }
}

Try it out!