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://uat-apigateway.voyzantonline.com/AirOfferPrice' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
--header 'x-api-key: <your key here>' \
--header 'Content-Type: application/json'\ 

Request Body Sample

{
    "OfferPriceRQ": {
        "Document": {
            "Name": "Voyzant Portal",
            "ReferenceVersion": "1.0"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "Voyzant Agency",
                    "IATA_Number": "1111111111",
                    "AgencyID": "1111111111",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "test@email.com"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1679558717852165006",
        "Query": {
            "Offer": [
                {
                    "OfferID": "3296198721679558734648373563"
                }
            ]
        },
        "DataLists": {
            "PassengerList": {
                "Passenger": [
                    {
                        "PassengerID": "T1",
                        "PTC": "ADT"
                    }
                ]
            }
        },
        "MetaData": {
            "TraceId": "161777799749"
        }
    }
}

Response Sample

{
    "OfferPriceRS": {
        "Document": {
            "Name": "API GATEWAY",
            "ReferenceVersion": "1.2"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "Voyzant Agency",
                    "IATA_Number": "",
                    "AgencyID": "Voyzant Agency",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "pst@voyzant.com"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1679558717852165006",
        "OfferResponseId": "1679558776693866670",
        "Success": {},
        "PricedOffer": [
            {
                "OfferID": "3296198721679558734648373563",
                "Owner": "AF",
                "OwnerName": "Air France",
                "IsBrandedFare": "N",
                "BrandedFareOptions": [],
                "CabinOptions": [],
                "IsAdditionalCabinType": "N",
                "Eticket": "false",
                "AllowHold": "Y",
                "TimeLimits": {
                    "OfferExpirationDateTime": "2023-03-23T10:06:17",
                    "PaymentExpirationDateTime": "2023-03-27 03:00:00"
                },
                "PassportRequired": "N",
                "BookingCurrencyCode": "CAD",
                "EquivCurrencyCode": "CAD",
                "HstPercentage": "",
                "RewardSettings": {
                    "RewardAvailable": "N",
                    "PointTypes": [],
                    "PointValues": {}
                },
                "BookingFeeInfo": {
                    "FeeType": "",
                    "BookingCurrencyPrice": 0,
                    "EquivCurrencyPrice": 0
                },
                "TotalPrice": {
                    "BookingCurrencyPrice": 841.96,
                    "EquivCurrencyPrice": 841.96
                },
                "BasePrice": {
                    "BookingCurrencyPrice": 414,
                    "EquivCurrencyPrice": 414
                },
                "TaxPrice": {
                    "BookingCurrencyPrice": 427.96,
                    "EquivCurrencyPrice": 427.96
                },
                "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": "NA",
                            "EquivCurrencyPrice": "NA"
                        },
                        "After": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        }
                    },
                    "CancelationFee": {
                        "Before": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        },
                        "After": {
                            "BookingCurrencyPrice": "NA",
                            "EquivCurrencyPrice": "NA"
                        }
                    }
                },
                "OfferItem": [
                    {
                        "OfferItemID": "OFFERITEMID1",
                        "Refundable": "true",
                        "PassengerType": "ADT",
                        "PassengerQuantity": 1,
                        "TotalPriceDetail": {
                            "TotalAmount": {
                                "BookingCurrencyPrice": 841.96,
                                "EquivCurrencyPrice": 841.96
                            }
                        },
                        "Service": [
                            {
                                "ServiceID": "SV1",
                                "PassengerRefs": "ADT1",
                                "FlightRefs": "Flight1"
                            }
                        ],
                        "FareDetail": {
                            "PassengerRefs": "ADT1",
                            "Price": {
                                "TotalAmount": {
                                    "BookingCurrencyPrice": 841.96,
                                    "EquivCurrencyPrice": 841.96
                                },
                                "BaseAmount": {
                                    "BookingCurrencyPrice": 414,
                                    "EquivCurrencyPrice": 414
                                },
                                "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": "YQ",
                                        "BookingCurrencyPrice": 25,
                                        "EquivCurrencyPrice": 25
                                    },
                                    {
                                        "TaxCode": "YR",
                                        "BookingCurrencyPrice": 337.5,
                                        "EquivCurrencyPrice": 337.5
                                    },
                                    {
                                        "TaxCode": "CA",
                                        "BookingCurrencyPrice": 25.91,
                                        "EquivCurrencyPrice": 25.91
                                    },
                                    {
                                        "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": "NLX79NBL/AU330"
                                    },
                                    "RBD": "N",
                                    "CabinType": "Y",
                                    "SeatLeft": "9"
                                }
                            }
                        ]
                    }
                ],
                "BaggageAllowance": [
                    {
                        "SegmentRefs": "Segment1",
                        "PassengerRefs": "T1",
                        "BaggageAllowanceRef": "Bag1"
                    }
                ],
                "SplitPaymentInfo": [
                    {
                        "AirItineraryId": "3296198721679558734648373563",
                        "MultipleFop": "N",
                        "MaxCardsPerPax": 0,
                        "MaxCardsPerPaxInMFOP": 0
                    }
                ],
                "BookingToEquivExRate": 1,
                "FopRef": "FOP_1341_0_1987_0_ALL_PRI"
            }
        ],
        "DataLists": {
            "PassengerList": {
                "Passengers": [
                    {
                        "PassengerID": "T1",
                        "PTC": "ADT"
                    }
                ]
            },
            "DisclosureList": {
                "Disclosures": []
            },
            "FareList": {
                "FareGroup": [
                    {
                        "FareGroupRef": "FG_1",
                        "FareCode": "749",
                        "FareBasisCode": "NLX79NBL/AU330"
                    }
                ]
            },
            "FlightSegmentList": {
                "FlightSegment": [
                    {
                        "SegmentKey": "Segment1",
                        "Departure": {
                            "AirportCode": "YYZ",
                            "Date": "2023-04-17",
                            "Time": "23:15:00",
                            "AirportName": "Lester B. Pearson International Airport",
                            "Terminal": {
                                "Name": "3"
                            }
                        },
                        "Arrival": {
                            "AirportCode": "CDG",
                            "Date": "2023-04-18",
                            "Time": "12:35:00",
                            "AirportName": "Charles de Gaulle International Airport",
                            "Terminal": {
                                "Name": "2E"
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "AF",
                            "Name": "Air France",
                            "FlightNumber": "357"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "AF",
                            "Name": "Air France",
                            "FlightNumber": "357"
                        },
                        "Equipment": {
                            "AircraftCode": "772",
                            "Name": "Boeing 777-200 pax"
                        },
                        "Code": {
                            "MarriageGroup": "O"
                        },
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "7 H 20 M"
                            },
                            "Stops": {
                                "Value": 0
                            },
                            "InterMediate": [],
                            "AirMilesFlown": 0
                        },
                        "BrandId": ""
                    }
                ]
            },
            "FlightList": {
                "Flight": [
                    {
                        "FlightKey": "Flight1",
                        "Journey": {
                            "Time": "7 H 20 M",
                            "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": "1",
                            "Unit": "Pieces"
                        }
                    }
                ]
            },
            "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": {
                                "F": {
                                    "BookingCurrencyPrice": 0,
                                    "EquivCurrencyPrice": 0
                                },
                                "P": 0
                            },
                            "DUS": {
                                "F": {
                                    "BookingCurrencyPrice": 0,
                                    "EquivCurrencyPrice": 0
                                },
                                "P": 0
                            },
                            "MA": {
                                "F": {
                                    "BookingCurrencyPrice": 0,
                                    "EquivCurrencyPrice": 0
                                },
                                "P": 0
                            },
                            "DS": {
                                "F": {
                                    "BookingCurrencyPrice": 0,
                                    "EquivCurrencyPrice": 0
                                },
                                "P": 0
                            },
                            "TP": {
                                "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": "N",
                        "Types": {}
                    },
                    "FopKey": "FOP_1341_0_1987_0_ALL_PRI"
                }
            ]
        },
        "MetaData": {}
    }
}

Try it out!