AirOfferPrice

AirOfferPrice that allows users to retrieve rates for specific travel requirements and to price a particular Shopping Response ID and Offer ID.

This returns the Response with total price for the selected itinerary, including taxes, fees, or other charges associated with the booking.

As it provides customers with accurate and up-to-date pricing information for their travel plans.

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


OfferID: When a customer performs a search for flights, the airline generates a list of available offers that meet the customer’s search criteria. Each offer within that list is assigned a unique OfferID.

It is important to provide the correct numeric value to ensure that the system can identify the correct offer

This is the required field, and the value will be String.


  • Passenger: This is an Array.

Note: This is a required field. Passenger list must have at least one adult. Infant object count should be less than or equal to adult count. Total passenger count should be less than or eqaul to 9.

  • PassengerID: Provide the passenger ID assigned to you. Valid values are T1, T2, and T3. The value will be String.

  • PTC: Provide the passenger type. Valid values are ADT, CHD, and INF. The value will be String.


TraceId: Provide the Trace ID. This is a String value.

Request URL

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

Request Body Sample

{
    "OfferPriceRQ": {
        "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"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1678284796766733395",
        "Query": {
            "Offer": [
                {
                    "OfferID": "77061721678284802555453313"
                }
            ]
        },
        "DataLists": {
            "PassengerList": {
                "Passenger": [
                    {
                        "PassengerID": "T1",
                        "PTC": "ADT"
                    }
                ]
            }
        },
        "MetaData": {
            "TraceId": "161777799749"
        }
    }
}

Response Sample

{
    "OfferPriceRS": {
        "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": "1678284796766733395",
        "OfferResponseId": "1678284832897795647",
        "Success": {},
        "PricedOffer": [
            {
                "OfferID": "77061721678284802555453313",
                "Owner": "AC",
                "OwnerName": "Air Canada",
                "IsBrandedFare": "N",
                "BrandedFareOptions": [],
                "CabinOptions": [],
                "IsAdditionalCabinType": "N",
                "Eticket": "true",
                "AllowHold": "Y",
                "TimeLimits": {
                    "OfferExpirationDateTime": "2023-03-08T21:44:03",
                    "PaymentExpirationDateTime": "2023-03-11 14:14:00"
                },
                "PassportRequired": "N",
                "BookingCurrencyCode": "CAD",
                "EquivCurrencyCode": "CAD",
                "HstPercentage": "",
                "RewardSettings": {
                    "RewardAvailable": "N",
                    "PointTypes": [],
                    "PointValues": {}
                },
                "BookingFeeInfo": {
                    "FeeType": "",
                    "BookingCurrencyPrice": 0,
                    "EquivCurrencyPrice": 0
                },
                "TotalPrice": {
                    "BookingCurrencyPrice": 3551.93,
                    "EquivCurrencyPrice": 3551.93
                },
                "BasePrice": {
                    "BookingCurrencyPrice": 2735,
                    "EquivCurrencyPrice": 2735
                },
                "TaxPrice": {
                    "BookingCurrencyPrice": 816.93,
                    "EquivCurrencyPrice": 816.93
                },
                "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": 3551.93,
                                "EquivCurrencyPrice": 3551.93
                            }
                        },
                        "Service": [
                            {
                                "ServiceID": "SV1",
                                "PassengerRefs": "ADT1",
                                "FlightRefs": "Flight1"
                            },
                            {
                                "ServiceID": "SV2",
                                "PassengerRefs": "ADT1",
                                "FlightRefs": "Flight2"
                            }
                        ],
                        "FareDetail": {
                            "PassengerRefs": "ADT1",
                            "Price": {
                                "TotalAmount": {
                                    "BookingCurrencyPrice": 3551.93,
                                    "EquivCurrencyPrice": 3551.93
                                },
                                "BaseAmount": {
                                    "BookingCurrencyPrice": 2735,
                                    "EquivCurrencyPrice": 2735
                                },
                                "TaxAmount": {
                                    "BookingCurrencyPrice": 816.93,
                                    "EquivCurrencyPrice": 816.93
                                },
                                "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": 4.55,
                                        "EquivCurrencyPrice": 4.55
                                    },
                                    {
                                        "TaxCode": "SQ",
                                        "BookingCurrencyPrice": 35,
                                        "EquivCurrencyPrice": 35
                                    },
                                    {
                                        "TaxCode": "CA",
                                        "BookingCurrencyPrice": 25.91,
                                        "EquivCurrencyPrice": 25.91
                                    },
                                    {
                                        "TaxCode": "YQ",
                                        "BookingCurrencyPrice": 675,
                                        "EquivCurrencyPrice": 675
                                    },
                                    {
                                        "TaxCode": "ZR",
                                        "BookingCurrencyPrice": 3.7,
                                        "EquivCurrencyPrice": 3.7
                                    },
                                    {
                                        "TaxCode": "F6",
                                        "BookingCurrencyPrice": 25.94,
                                        "EquivCurrencyPrice": 25.94
                                    },
                                    {
                                        "TaxCode": "I2",
                                        "BookingCurrencyPrice": 3.55,
                                        "EquivCurrencyPrice": 3.55
                                    },
                                    {
                                        "TaxCode": "OM",
                                        "BookingCurrencyPrice": 35.48,
                                        "EquivCurrencyPrice": 35.48
                                    },
                                    {
                                        "TaxCode": "S6",
                                        "BookingCurrencyPrice": 7.8,
                                        "EquivCurrencyPrice": 7.8
                                    }
                                ]
                            }
                        },
                        "FareComponent": [
                            {
                                "PriceClassRef": "PCR_1",
                                "SegmentRefs": "Segment1 Segment2",
                                "FareBasis": {
                                    "FareBasisCode": {
                                        "Refs": "FG_1 FG_1",
                                        "Code": "BFFE/CS00 BFFE/CS00"
                                    },
                                    "RBD": "B B",
                                    "CabinType": "Y Y",
                                    "SeatLeft": "9 4"
                                }
                            },
                            {
                                "PriceClassRef": "PCR_1",
                                "SegmentRefs": "Segment3 Segment4",
                                "FareBasis": {
                                    "FareBasisCode": {
                                        "Refs": "FG_1 FG_1",
                                        "Code": "BFFE/CS00 BFFE/CS00"
                                    },
                                    "RBD": "B B",
                                    "CabinType": "Y Y",
                                    "SeatLeft": "4 9"
                                }
                            }
                        ]
                    }
                ],
                "BaggageAllowance": [
                    {
                        "SegmentRefs": "Segment1 Segment2 Segment3 Segment4",
                        "PassengerRefs": "T1",
                        "BaggageAllowanceRef": "Bag1"
                    }
                ],
                "SplitPaymentInfo": [
                    {
                        "AirItineraryId": "77061721678284802555453313",
                        "MultipleFop": "Y",
                        "MaxCardsPerPax": 2,
                        "MaxCardsPerPaxInMFOP": 1
                    }
                ],
                "BookingToEquivExRate": 1,
                "FopRef": "FOP_196_0_617_0_ALL_PRI"
            }
        ],
        "DataLists": {
            "PassengerList": {
                "Passengers": [
                    {
                        "PassengerID": "T1",
                        "PTC": "ADT"
                    }
                ]
            },
            "DisclosureList": {
                "Disclosures": []
            },
            "FareList": {
                "FareGroup": [
                    {
                        "FareGroupRef": "FG_1",
                        "FareCode": "749",
                        "FareBasisCode": "BFFE/CS00"
                    }
                ]
            },
            "FlightSegmentList": {
                "FlightSegment": [
                    {
                        "SegmentKey": "Segment1",
                        "Departure": {
                            "AirportCode": "YYZ",
                            "Date": "2023-04-14",
                            "Time": "22:35:00",
                            "AirportName": "Lester B. Pearson International Airport",
                            "Terminal": {
                                "Name": "1"
                            }
                        },
                        "Arrival": {
                            "AirportCode": "DXB",
                            "Date": "2023-04-15",
                            "Time": "19:45:00",
                            "AirportName": "Dubai International Airport",
                            "Terminal": {
                                "Name": "1"
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "56"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "56"
                        },
                        "Equipment": {
                            "AircraftCode": "789",
                            "Name": "789"
                        },
                        "Code": {
                            "MarriageGroup": "O"
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "13 H 10 M"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": 6899
                        },
                        "BrandId": "LT"
                    },
                    {
                        "SegmentKey": "Segment2",
                        "Departure": {
                            "AirportCode": "DXB",
                            "Date": "2023-04-16",
                            "Time": "02:15:00",
                            "AirportName": "Dubai International Airport",
                            "Terminal": {
                                "Name": "3"
                            }
                        },
                        "Arrival": {
                            "AirportCode": "MCT",
                            "Date": "2023-04-16",
                            "Time": "03:30:00",
                            "AirportName": "Muscat International Airport",
                            "Terminal": {
                                "Name": ""
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "7590"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "EK",
                            "Name": "Emirates",
                            "FlightNumber": "866"
                        },
                        "Equipment": {
                            "AircraftCode": "77W",
                            "Name": "Boeing 777-300ER"
                        },
                        "Code": {
                            "MarriageGroup": "I"
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "1 H 15 M"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": 217
                        },
                        "BrandId": "LT"
                    },
                    {
                        "SegmentKey": "Segment3",
                        "Departure": {
                            "AirportCode": "MCT",
                            "Date": "2023-04-22",
                            "Time": "11:20:00",
                            "AirportName": "Muscat International Airport",
                            "Terminal": {
                                "Name": ""
                            }
                        },
                        "Arrival": {
                            "AirportCode": "DXB",
                            "Date": "2023-04-22",
                            "Time": "12:25:00",
                            "AirportName": "Dubai International Airport",
                            "Terminal": {
                                "Name": "3"
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "7591"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "EK",
                            "Name": "Emirates",
                            "FlightNumber": "863"
                        },
                        "Equipment": {
                            "AircraftCode": "77W",
                            "Name": "Boeing 777-300ER"
                        },
                        "Code": {
                            "MarriageGroup": "O"
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "1 H 5 M"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": 217
                        },
                        "BrandId": "LT"
                    },
                    {
                        "SegmentKey": "Segment4",
                        "Departure": {
                            "AirportCode": "DXB",
                            "Date": "2023-04-23",
                            "Time": "02:00:00",
                            "AirportName": "Dubai International Airport",
                            "Terminal": {
                                "Name": "1"
                            }
                        },
                        "Arrival": {
                            "AirportCode": "YYZ",
                            "Date": "2023-04-23",
                            "Time": "08:05:00",
                            "AirportName": "Lester B. Pearson International Airport",
                            "Terminal": {
                                "Name": "1"
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "57"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "AC",
                            "Name": "Air Canada",
                            "FlightNumber": "57"
                        },
                        "Equipment": {
                            "AircraftCode": "789",
                            "Name": "789"
                        },
                        "Code": {
                            "MarriageGroup": "I"
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "14 H 5 M"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": 6899
                        },
                        "BrandId": "LT"
                    }
                ]
            },
            "FlightList": {
                "Flight": [
                    {
                        "FlightKey": "Flight1",
                        "Journey": {
                            "Time": "20 H 55 M",
                            "Stops": 1
                        },
                        "SegmentReferences": "Segment1 Segment2"
                    },
                    {
                        "FlightKey": "Flight2",
                        "Journey": {
                            "Time": "28 H 45 M",
                            "Stops": 1
                        },
                        "SegmentReferences": "Segment3 Segment4"
                    }
                ]
            },
            "OriginDestinationList": {
                "OriginDestination": [
                    {
                        "OriginDestinationKey": "OD1",
                        "DepartureCode": "YYZ",
                        "ArrivalCode": "MCT",
                        "FlightReferences": "Flight1"
                    },
                    {
                        "OriginDestinationKey": "OD2",
                        "DepartureCode": "MCT",
                        "ArrivalCode": "YYZ",
                        "FlightReferences": "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": "2",
                            "Unit": "Pieces"
                        }
                    }
                ]
            },
            "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
                                }
                            },
                            "JC": {
                                "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_196_0_617_0_ALL_PRI"
                }
            ]
        },
        "MetaData": {}
    }
}

Try it out!