Brand Detail Pricing
Requesting brand details in the AirPrice request returns the brand tier and summary brand content associated with a fare. As in the search APIs, brand details allow you to determine if features such a meals or a carry-on bag are available and whether each is included in the fare or available at an extra charge.
In this topic:
Brand Pricing
Note that when requesting brand pricing with lowFareFindInd set to true, AirPrice uses only the brand tier (and any other pricing modifiers) to find the lowest fare within a brand tier regardless of class of service.
Brand Pricing Request
AirPrice does not return branded fares by default. To return branded fares, in the request:
- Set returnBrandedFaresInd to true. If not sent the default value is false.
- Send SpecificFlightCriteria @brandTier with the brand tier to price. Sending @brandTier is currently supported only with the full payload request.
If no brand content exists for the itinerary, the AirPrice response prices the itinerary and returns a message that no brands are available.
Show Example Full Payload Price Request with brand details (GDS)
The following example shows a full payload request for brand pricing. All brand-related attributes are highlighted. The full payload request is supported only for GDS, not NDC.
{
"OfferQueryBuildFromProducts":{
"fareRuleType":"null",
"lowFareFinderInd":"true",
"returnBrandedFaresInd":"true",
"BuildFromProductsRequest":{
"@type":"BuildFromProductsRequestAir",
"PassengerCriteria":[
{
"number":"1",
"value":"ADT",
"age":24
},
{
"number":"1",
"value":"CHD",
"age":14
},
{
"number":"1",
"value":"INF",
"age":1
}
],
"ProductCriteriaAir":[
{
"SpecificFlightCriteria":[
{
"@type":"SpecificFlightCriteria",
"carrier":"EK",
"flightNumber":"525",
"departureDate":"2019-04-24",
"departureTime":"04:35:00",
"arrivalDate":"2019-04-24",
"arrivalTime":"06:40:00",
"from":"HYD",
"to":"DXB",
"cabin":"Economy",
"classOfService":"U",
"segmentSequence":"0",
"brandTier":3
}
]
},
{
"SpecificFlightCriteria":[
{
"@type":"SpecificFlightCriteria",
"carrier":"EK",
"flightNumber":"528",
"departureDate":"2019-04-28",
"departureTime":"15:10:00",
"arrivalDate":"2019-04-28",
"arrivalTime":"20:15:00",
"from":"DXB",
"to":"HYD",
"cabin":"Economy",
"classOfService":"U",
"segmentSequence":"0",
"brandTier":3
}
]
}
]
}
}
}The following example shows a reference payload brand pricing request for an NDC itinerary. The reference payload is supported for both NDC and GDS.
{
"OfferQueryBuildFromCatalogOfferings": {
"returnBrandedFaresInd": true,
"BuildFromCatalogOfferingsRequest": {
"@type": "BuildFromCatalogOfferingsRequestAir",
"CatalogOfferingsIdentifier": {
"Identifier": {
"value": "8bb5c02e-8608-43af-85c2-aad4a97edce9"
}
},
"CatalogOfferingIdentifier": {
"Identifier": {
"value": "o0.0"
}
},
"ProductIdentifier": [
{
"Identifier": {
"value": "p0"
}
}
]
}
}
}Brand Details Response
When brand details are is requested, the response may include multiple flights with the same brand information. So, in a pricing response with brand details, common brand details are consolidated across flights in the ReferenceListBrand object. For each flight, an internal identifier in the offer matches to an identifier ReferenceListBrand/Brand, which lists brand attributes.
Brand identifiers start with the letter b, as in b1, b2, and so on. For NDC, brand numbers incorporate the carrier code; for example, QFb1, AAb2.
The BrandAttribute object contains one or more instances of the key value pairs classification and inclusion, as follows:
- classification: Returns any of seven possible values:
- CarryOn
- CheckedBag
- Meals
- Seats
- Rebooking
- Refund
- Wifi
- inclusion: Notes whether the brand attribute in classification is included in the price of the fare or is chargeable. Possible values are:
- Included: The attribute is included in the fare at no additional charge.
- Chargeable: The attribute is included in the fare at a cost.
Show Example Brand Details Price Response
{
"OfferResponse":{
"Offer":{
"@type":"Offer",
"id":"o0",
"Product":[
{
"@type":"ProductAir",
"totalDuration":"PT3H35M",
"id":"p0",
"FlightSegment":[
{
"id":"s1",
"sequence":1,
"Flight":{
"@type":"Flight",
"duration":"PT3H35M",
"carrier":"EK",
"number":"525",
"operatingCarrier":"EK",
"operatingCarrierName":"Emirates",
"id":"f1",
"Departure":{
"@type":"Departure",
"location":"HYD",
"date":"2019-04-24",
"time":"04:35:00"
},
"Arrival":{
"@type":"Arrival",
"location":"DXB",
"date":"2019-04-24",
"time":"06:40:00"
}
}
}
],
"PassengerFlight":[
{
"passengerQuantity":1,
"passengerTypeCode":"ADT",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHXESIN1",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
},
{
"passengerQuantity":1,
"passengerTypeCode":"INF",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHXESIN1IN",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
},
{
"passengerQuantity":1,
"passengerTypeCode":"CHD",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHXESIN1CH",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
}
]
},
{
"@type":"ProductAir",
"totalDuration":"PT3H35M",
"id":"p1",
"FlightSegment":[
{
"id":"s2",
"sequence":1,
"Flight":{
"@type":"Flight",
"duration":"PT3H35M",
"carrier":"EK",
"number":"528",
"operatingCarrier":"EK",
"operatingCarrierName":"Emirates",
"id":"f2",
"Departure":{
"@type":"Departure",
"location":"DXB",
"date":"2019-04-28",
"time":"15:10:00"
},
"Arrival":{
"@type":"Arrival",
"location":"HYD",
"date":"2019-04-28",
"time":"20:15:00"
}
}
}
],
"PassengerFlight":[
{
"passengerQuantity":1,
"passengerTypeCode":"ADT",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHWESIN1",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
},
{
"passengerQuantity":1,
"passengerTypeCode":"INF",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHWESIN1IN",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
},
{
"passengerQuantity":1,
"passengerTypeCode":"CHD",
"FlightProduct":[
{
"segmentSequence":[
1
],
"classOfService":"U",
"cabin":"Economy",
"fareBasisCode":"UHWESIN1CH",
"Brand":{
"@type":"Brand",
"BrandRef":"b1"
}
}
]
}
]
}
],
"Price":{
"@type":"PriceDetail",
"currencyCode":"USD",
"id":"price0",
"Base":"708.00",
"TotalTaxes":"500.10",
"TotalFees":"0.00",
"TotalPrice":"1208.10",
"PriceBreakdown":[
{
"@type":"PriceBreakdownAir",
"quantity":1,
"requestedPassengerType":"ADT",
"Amount":{
"Base":"383.00",
"Taxes":{
"@type":"TaxesDetail",
"TotalTaxes":"251.50",
"Tax":[
{
"taxCode":"IN",
"value":28.5
},
{
"taxCode":"K3",
"value":27
},
{
"taxCode":"WO",
"value":5.9
},
{
"taxCode":"AE",
"value":20.4
},
{
"taxCode":"F6",
"value":9.5
},
{
"taxCode":"TP",
"value":1.4
},
{
"taxCode":"ZR",
"value":2.8
},
{
"taxCode":"YQ",
"value":156
}
]
},
"Fees":{
"@type":"FeesDetail",
"TotalFees":"0.00"
},
"Total":"634.50"
}
},
{
"@type":"PriceBreakdownAir",
"quantity":1,
"requestedPassengerType":"INF",
"Amount":{
"Base":"38.00",
"Taxes":{
"@type":"TaxesDetail",
"TotalTaxes":"1.90",
"Tax":[
{
"taxCode":"K3",
"value":1.9
}
]
},
"Fees":{
"@type":"FeesDetail",
"TotalFees":"0.00"
},
"Total":"39.90"
}
},
{
"@type":"PriceBreakdownAir",
"quantity":1,
"requestedPassengerType":"CHD",
"Amount":{
"Base":"287.00",
"Taxes":{
"@type":"TaxesDetail",
"TotalTaxes":"246.70",
"Tax":[
{
"taxCode":"IN",
"value":28.5
},
{
"taxCode":"K3",
"value":22.2
},
{
"taxCode":"WO",
"value":5.9
},
{
"taxCode":"AE",
"value":20.4
},
{
"taxCode":"F6",
"value":9.5
},
{
"taxCode":"TP",
"value":1.4
},
{
"taxCode":"ZR",
"value":2.8
},
{
"taxCode":"YQ",
"value":156
}
]
},
"Fees":{
"@type":"FeesDetail",
"TotalFees":"0.00"
},
"Total":"533.70"
}
}
]
},
"TermsAndConditionsFull":[
{
"@type":"TermsAndConditionsFullAir",
"validatingCarrier":"EK",
"ExpiryDate":"2019-02-25T04:59:00Z",
"BaggageAllowance":[
{
"@type":"BaggageAllowanceDetail",
"url":"http://VIEWTRIP.TRAVELPORT.COM/BAGGAGEPOLICY/EK",
"passengerTypeCodes":[
"ADT",
"INF",
"CHD"
],
"baggageType":"FirstCheckedBag",
"ProductRef":[
"p0"
],
"BaggageItem":[
{
"quantity":1,
"Text":"CHGS MAY APPLY IF BAGS EXCEED TTL WT ALLOWANCE"
}
],
"SegmentSequenceList":[
1
]
},
{
"@type":"BaggageAllowanceDetail",
"url":"http://VIEWTRIP.TRAVELPORT.COM/BAGGAGEPOLICY/EK",
"passengerTypeCodes":[
"ADT",
"INF",
"CHD"
],
"baggageType":"SecondCheckedBag",
"ProductRef":[
"p0"
],
"BaggageItem":[
{
"quantity":1,
"Text":"CHGS MAY APPLY IF BAGS EXCEED TTL WT ALLOWANCE"
}
],
"SegmentSequenceList":[
1
]
},
{
"@type":"BaggageAllowanceDetail",
"passengerTypeCodes":[
"INF"
],
"baggageType":"CarryOn",
"ProductRef":[
"p1"
],
"BaggageItem":[
{
"quantity":1,
"BaggageFee":{
"code":"USD",
"approximateInd":true,
"value":0
},
"Text":"UPTO11LB/5KG AND UPTO45LI/115LCM"
}
],
"SegmentSequenceList":[
1
],
"Text":"1P"
}
]
}
]
},
"ReferenceList":[
{
"@type":"ReferenceListBrand",
"Brand":[
{
"@type":"Brand",
"name":"Economy Flex",
"tier":3,
"id":"b1",
"Identifier":{
"authority":"Travelport",
"value":"177280"
},
"BrandAttribute":[
{
"classification":"CarryOn",
"inclusion":"Included"
},
{
"classification":"WiFi",
"inclusion":"Included"
},
{
"classification":"CheckedBag",
"inclusion":"Included"
},
{
"classification":"Meals",
"inclusion":"Included"
},
{
"classification":"Seats",
"inclusion":"Included"
},
{
"classification":"Rebooking",
"inclusion":"Chargeable"
},
{
"classification":"Refund",
"inclusion":"Chargeable"
}
]
}
]
}
]
}
}