Skip to navigation

Quote request data dictionary

Every element the Partner can send in a JSON Quote Request.
ElementTypeDefinition
Locationobject
citystringThe city in the travel itinerary.
codestringThe airport code or other identifier for the location.
countrystringThe 2 letter abbreviation or code country for the location.
regionstringThe abbreviation or code for state province or region.
Addressobject
address1stringFirst line of address. Do not persist for customer.
address2stringSecond line of address. Do not persist for customer.
citystringAddress city. Do not persist for customer.
countrystringThe country for this address.
postalCodestringThe postal code for this address. Do not persist for customer.
regionstringThe abbreviation or code for state province or region. Referenced in Origin elements in for travel.
Membershipobject
levelstringStatus or level of membership.
namestringThe name of the membership.
numberstringThe membership number assigned to the member.
typestringThe type of membership.
Customerobject
ageintegerAge of the customer.
assistanceTypestringThese are values provided by the partner which provide information into what type of assistance is needed by the customer during their travel.
birthDatestringBirthdate of the customer. Do not persist.
canPersistbooleanIndicates whether the customer information may be persisted to the AWP database.
customerIdstringUnique identifier generated by Partner to identify customer.
customerTypestringDescriptive category for the traveler. Values may be vertical-specific. (Adult Child Infant Senior …)
demographicInfoobject
occupationstringOccupation of the customer. Do not persist.
emailAddressstringEmail address of policyholder. Do not persist.
firstNamestringFirst name of customer. Not Persisted.
genderstringGender of the customer.
includeForPricingbooleanIndicates should be included in AWP internal traveler group pricing.
includeInGroupDeterminationbooleanIndicates should be included in AWP internal traveler group pricing.
lastNamestringLast name of customer. Not Persisted.
membershipsarray
middleInitialstringMiddle initial of traveler. Do not persist.
nationalitystring
okToContactbooleanIndicates whether marketing representatives may contact the customer.
optionsarray
phonesarray
itemsobject
areaCodestringrepresents the area code of customer’s phone number
countryCodestringrepresents the country code of customer’s phone number
isPrimarybooleanIndicates if this phone number can be treated as the primary phone number for the customer
numberstringRepresents the customer’s phone number. Not persisted.
typestringType of customer’s phone - Home Work Mobile etc.
relationshipToPrimarystringRelationship of the person in the sequence to the primary customer.
salutationstringThe nickname or greeting the customer prefers to be called. Do not persist
sequenceintegerThe sequential order of the primary driver in the list. In most cases this would be the first position in the list.
suffixstringA name suffix if used. Do not persist
titlestringA personal title if used. Do not persist
totalCostnumberTravel cost per traveler. Iindividual cost relating to the transaction item (Motor or Travel or Event etc..)
Vehicleobject
ageintegerAge of the vehicle.
annualDistanceintegerEstimated annual miles driven with the vehicle.
antiTheftDevicestringWhether or not vehicle has an anit theft device.
associatedTrailerSequenceintegerSequence number of the associated trailer.
bodyStylestringThe body style of the vehicle.
colorstringThe painted color of the vehicle.
editionstringThe edition of the vehicle.
engineSizeintegerThe size of the vehicle engine in millileters. (4200 = 4.2)
firstRegistrationDatestringThe date on which the vehicle was first registered.
fuelTypestringThe type of fuel used in the vehicle.
horsePowerintegerHorse power or power (kw) as a number.
imageURLstringImage of the vehicle
isForBusinessUsebooleanIs the vehicle used for business.
isHighMileagebooleanIs the vehicle considered in the high-mileage range by the partner.
isOriginalOwnerbooleanIs the current owner the original owner
lastRegistrationDatestringThe most recent registration date of the vehicle.
manufactureDatestringThe year the vehicle was manufactured.
manufacturerstringName of the vehicle manufacturer.
modelstringThe model of the Vehicle.
optionsarray
parkedAtNightLocationstringWhere the vehicle is parked at night.
plateNumberstringThe plate or tag number issued when the vehicle was registered.
primaryDriverSequenceintegerThe sequential order of the primary driver in the list. In most cases this would be the first position in the list.
primaryUsestringPrimary use of the vehicle.
regionWhereRegisteredstringState province or region where vehicle is registered.
riskCategorystringPartner-defined risk.
sequenceintegerThe sequence number of the vehicle in the request.
situationOfRiskstringPartner-defined
valuenumberThe current value of the vehicle in the currency type of the partner.
vehicleIdentificationstringA unique identifier assigned to this vehcle by the governing authority such as the VIN assigned in the US).
vehicleTypestringThe type of vehicle to be insured.
weightintegerWeight of the vehicle
yearsOwnedinteger# years the vehicle in under ownership
MotorRelatedobject
distanceToWorkintegerThe distance the driver travels to work.
driverCategorystringIndicates a category of the driver.
hasCommuterTicketbooleanIndicates whether the driver is the holder of a commuter railway ticket.
hasMileageAllowancebooleanIndicates whether the driver has a job-related mileage allowance.
isDrivingOtherCarsbooleanIndicates whether the driver has use of other cars.
isFulltimeCarUsebooleanIndicates the car will be in fulltime use by the drivers.
licenceStatusstringThe status of the license held by the driver.
licenceTypestringThe type of license held by the driver.
noClaimsBonusCodestringThe code used to identify the bonus offered to the customer.
noClaimsStepCodestringIf applicable a step code for the no-claim bonus code.
noClaimsYearsintegerYears of no claim for the driver.
noClaimsYearsNamedDriverintegerThe no-claim years for a driver other than the primary driver.
noClaimsYearsOwnNameintegerThe no-claim years for the primary driver.
penaltyPointsintegerThe Total penalty points against the driver.
yearFirstLicenceHeldintegerThe year the driver first obtained a licence.
TravelLegobject
arrivalDatestringArrival Date for this leg.
brandedFarestringTBD - Partner defined branded fare for travel leg.
classOfServicestringThe class of service for this segment
departureDatestringDeparture Date for this leg.
distanceTraveledintegerThe distance in miles for this segment
equipmentTypestringThe description of the equipment used for this segment
fareClassstringFare class code of this flight segment
isDomesticbooleanIndicates if trip is considered domestic by Partner.
layoverDurationinteger
optionsarray
routeGroupstringA route is defined by the origin and destination of a unit of travel. Routes can be combined into a group.
routeNumberstringThe flight number as assigned by the airline for this route.
seatAvailabilityintegerTotal number of available seats on the equipment type
seatCapacityintegerTotal number of seats the equipment type can support
sequenceintegerThe sequence of the traveling segment in the trip
travelDurationintegerThe length or duration of the trip in minutes
TravelSegmentobject
arrivalDatestringArrival Date for this segment.
brandedFarestringTBD - Partner defined branded fare for travel segment.
classOfServicestring
departureDatestringDeparture Date for this segment.
distanceTraveledinteger
fareClassstring
includesConnectionbooleanDoes this segment have more than 1 leg?
isDomesticbooleanIndicates if trip is considered domestic by Partner.
layoverDurationinteger
optionsarray
routeGroupstring
sequenceintegerThe sequence of the traveling segment in the trip
travelLegsarray
Travelobject
autoTrainbooleanIndicates that an autotrain is being booked.
brandedFarestringTBD - Partner defined branded fare for trip
classOfServicestringThe class of service in the booking e.g. business.
connectionstring? check which one is right (DB or Dictionary)
departureDatestringThe scheduled date of departure for the trip.
includesConnectionbooleanDoes this trip have more than 1 segment or leg?
isDomesticbooleanIndicates if trip is considered domestic by Partner.
optionsarray
refundablestringIndicates that the booking is refundable
returnDatestringThe scheduled date or return for the booking.
routeGroupstringA route is defined by the origin and destination of a unit of travel. Routes can be combined into a group.
ticketSalesTypestringThe type of tickets sold. (Pre-Sales VIP Members Only Fan club sales …)
totalCostnumberTotal cost including taxes surcharges and fees. In Air Wrapper a value > 0 is enforced
travelAgentstringThe agent or agent site that is booking the travel.
travelLegsarrayCollection of travel legs. Populate this when segments are not used.
travelPurposestringThe traveler’s purpose of travel.
travelSegmentsarrayCollection of segments
tripDurationintegerThe length or duration of the trip in days.
tripIndicatorstringThe type of trip booked. Should be either Round-trip; One-way; or Multicity.
SearchPreferenceobject
flexibleDatesbooleanIndicates whether flexible dates are used in the search criteria.
includeNearbyAirportsbooleanIndicates if nearby airports are included in the search criteria.
includeWeekendsbooleanIndicates if weekends were included in the search criteria.
maxPricenumberTop of the price range a customer is searching
minPricenumberBottom of the price range a customer is searching
searchByPricebooleanIndicates if price was used in the search criteria.
searchBySchedulebooleanIndicates if flight or event schedule was used in the search criteria.
AdditionalItemobject
costnumberThe cost of the additional item.
currencyTypestringThe type of currency being used in the form of the three character ISO format currency code.
descriptionstringThe description of the product.
externalIdentifierstringThe identifier used by the partner.
namestringThe name of the associated product.
optionsarray
quantityintegerThe number of the products in the request.
sequenceintegerThe sequence of the associated product.
totalCostnumberQuantity x Cost
Providerobject
isPrimarybooleanIndicates the primary product provider.
optionsarray
providerCodestringThe code used by the product provider.
providerNamestringThe name of the product provider.
providerTypestringThe type of product provider.
RequestDetailobject
businessUnitstringCountry where products are eligible to be sold.
clientVersionstringVersion of the JS
costIncludesarrayarray of items included in cost
itemsstring
currencystringThe type of currency being used in the form of the three character ISO format currency code.
cxidstringCustomer Experience ID. This value is returned by AWP in the first quote response so only applies in customer scenarios where the partner is making multiple quote requests within the customer’s browsing session.
dataSourcestringLine of Business Source for the data sent to AWP
exchangeRatenumberThe exchange rate that should be used to convert prices from their default currency into the requested currency
experimentVariantstringIndicates which experiment (marketing test) was origingally rendered so that it may be given again under the same circumstances or session
itemDeliveryMethodstringThe method for receipt of the ticket(s).
languagestringTwo character ISO format language code.
locationsarrayList of codes where we are allowed to optimize for the request.
itemsstringAWP location code
offerVersionIdintegerID that allows tracking of offer when Partner is transitioning between different AWP platform versions. Also allows AWP to align offers to different versions of the partner’s path.
optionsarray
redemptionPointsnumberThe number of program points being redeemed by the customer in the booking.
requestCategoriesarrayContains a delimited list of booking categories.
itemsstring
requestChannelstringThe partner’s site that sent this request.
requestedDatestringPopulates current server date by default - exposed for internal purposes
requestOriginstringThe location or logical entity within the partner’s site where the request originated (e.g. booking or managed reservations).
requestOriginPagestringThe specific page that sent this request.
requestingHoststringHost issuing request - Host URL (origin from WidgetRequest)
salesOriginTypestringThe location from which the booking was made.
sessionIdstringSession Id that AWP receives in the quote request. Allows AWP to track duplicate requests within same visitor session. Supports identification of duplicates in analytical activities.
trafficSourcestringDescribes source of traffic which brought the consumer to partner site prior to insurance purchase.
transactionIdstringAvailable for Partner to send a unique ID with their quote request which will flow through the entire transaction. AWP will return it in their response and the partner can send it back with the purchase request.
usePromotionCodebooleanIndicates that a promotion code was used for the booking.
verticalstringRequest line of business such as AIRFARE EVENT or MOTOR.
visitorIdstringUsed to help track a customer and the offers that they receive when the customer retursn to the site.
widgetKeystringUnique identifier generated by AWP for each client widget. Will be populated by the partner when interacting with the Widget/JS.
RequestProductSequenceobject
sequenceintegerThe number of the sequence.
sequenceTypestringThe name of the sequence. Ex: Leg or Segment
RequestProductOptionobject
namestringThe name of the product option. Ex: SeatGroup
valuestringThe value of the product option. Ex: ExtraLegRoom Upfront
RequestProductPriceobject
isAvailablebooleanIndicates if this product/option is not available for purchase.
isIncludedbooleanIndicates if the product/option is included with another product or package.
pricenumberThe price for the product
productOptionsarray
productSequencesarray
stepNamestringIndicates step that price is for.
RequestProductobject
isAvailablebooleanIndicates the product is available to the current customer.
isDefaultbooleanIndicates if partner has defaulted this selection.
isEditablebooleanCan user select and unselect this product?
isSelectedbooleanIndicates if the product was selected for purchase.
pricenumberThe price for the product if not priced differently per leg option or other factor.
pricePointsarray
productCodestringCode that uniquely defines the product.
supplierCodestringThe supplier code assigned by AWP.
Partnerobject
distributorCodestringThe partner code assigned by AWP.
externalCodestringThis is a code that the partner is assigned by other external systems. This may be needed for reporting and fulfilment purposes and can be different from the partner code that is assigned by AWP.
externalSubCodestringPlaceholder if additional code is needed.
Incidentobject
customerSequenceintegerThe sequencial order in the list of the specific customer to which the incident applies.
descriptionstringA more detailed description of the incident.
incidentTypestringA short code that describes the type of vehicle-related incident (e.g. SPEEDING DUI PARKING). Thse codes will be defined by the partner and/or provider.
penaltyPointsintegerThe penalty points for the specific incident.
vehicleSequenceintegerThe sequencial order in the list of the specific vehicle to which the incident applies.
Lodgingobject
accomodationTypestringAccomodation type being booked: Timeshare Hotel Vacation Rental Shared Accomodation etc.
agencyRatingnumberThe travel agency rating given by the preferred agency.
availabilitystringAirbnb groupings for properties (Limited Popular Rare etc)
cancelationPolicyTypestringWhether the cancellation policy on the Airbnb property is flexible or strict
carbonMonoxideDetectorbooleanWhether Airbnb property has a carbon monoxide detector
chainstringThe name of the hotel chain in the itinerary.
checkInDatestringThe hotel checkin date on the itinerary.
checkOutDatestringThe hotel checkout date on the itinerary.
cribbooleanIndicates a crib is needed for the booking.
eventNamestringThe name of the specific event in the itinerary.
fireExtinguisherbooleanProperty has fire extinguisher
hostNamestringFirst name of the host / DO NOT PERSIST
hostStatusstringStatus of Airbnb Property Host
hotTubbooleanProperty has hot tub
indoorFirePlacebooleanProperty has indoor fireplace
instantBookingbooleanWhether the Airbnb booking is an instant booking
levelOfServicestringLevel of service: World Class Service Mid-Range Service Budget/Limited Service etc.
locationCategorystringThe category of the hotel location as information of the area.
locationTypestringThe location of the accomodation as specified by the vendor.
namestringThe name of the specific hotel in the itinerary.
numberOfBedRoomsintegerNumber of bedrooms in unit
numberOfBookingUnitsintegerNumber of units in the property that are being booked for this request
optionsarray
petsAllowedbooleanAre pets allowed
propertyTypestringHouse appartment loft etc.
rateTypestringThe type of rate given for the booking.
refundablestringIndicates that the booking is refundable
rollawaybooleanIndicates a rollaway bed is needed for the booking.
roomTypestringWhether the property’s room is an entire home private room or shared room
smokeDetectorbooleanProperty has smoke detectors
smokingAllowedbooleanProperty allows smoking
starRatingnumberThis is the star rating given by travel industry.
thumbRatingnumberThis is the rating given by the end user (average of reviews). Varies by distributor.
totalCostnumberThe total cost including taxes fees and surcharges.
zonestringWhether a partner country of residence (BU) is the same as the accomodation’s country of residence is ‘domestic’ or ‘international’.
Gadgetobject
browserTypestringIndicates the type of browser used to access the website. For example: Internet Explorer
browserVersionstringIndicates the version of the browser used to access the website. For example: IE7
deviceCategorystringIndicates the category of device being used to access the partner website
deviceTypestringDescribes the brand of device used to access the partner website. For example: BlackBerry
ipAddressstringIP address of the computer or device which is being used when accessing the partner site
operatingSystemstringIndicates the operating system that the traveler is using when accessing the partner site
operatingSystemVersionstringIndicates the version of the operating system the traveler is using when accessing the partner site
requestingPlatformstringThe platform from which the request was initiated
requestingPlatformVersionstringVersion of the platform from which the request was initiated
userAgentstringUser Agent string that provides information about user’s device.
OfferTypeobject
offerDescriptionstringThe description of the offer requested.
offerTypeIdintegerThe id of the offer type.
optionsarray
Eventobject
artistIdintegerThe id given to the artist by the booking agent.
artistNamestringThe name of the artist being booked.
endDatestringThe date the event will end.
eventNamestringThe name of the event or show in the booking.
isPremiumSeatbooleanIndicates whether the ticket is a premium ticket (TRUE) for example Official Platinum Ticket or a standard seat (FALSE)
majorCategorystringThe main category of the event.
minorCategorystringThe sub-category of the event.
numberOfHoursintegerThe number of hours the event is scheduled to last.
offerTypesarray
onSaleDatestringThe date booking is opened for the event.
optionsarray
outdoorEventbooleanIndicates whether the event will be outdoors.
preSaleDatestringThe date that booking is opened for pre-sale tickets.
refundablestringIndicates that the booking is refundable
sequenceintegerThe sequential order of the event when multiple events are being booked.
startDatestringThe start date of the event.
ticketHoldersarray
ticketLimitintegerThe ticket limit per person.
ticketSalesTypestringThe type of tickets sold.
ticketTypestringShows ticket type.
totalCostnumberThe total cost including taxes fees and surcharges.
venueCodestringThe vendor’s id number for the venue.
venueNamestringThe name of the venue
RentalCarobject
carClassCodestringACRISS or other identifying car classification code
endDatestringThe date the car will be returned.
isDomesticbooleanIndicates if trip is considered domestic by Partner.
optionsarray
rentalCarAgencystringThe name of the agency renting the car.
rentalCarPickupLocationstringThe actual pickup location at origin.
startDatestringThe date on which the car will be picked up.
totalCostnumberThe total cost of the rental car.
Credentialsobject
passwordstringPassword set by AWP for the Partner. AWP will validate each request using Partner’s ACCAM User Id and Password.
userNamestringThe user name assigned to the partner by AWP.
Cookieobject
additionalItemsarrayAdditional items already selected as purchased by customer (these products will not optimimized)
cookiesarray
customersarray
eventsarray
incidentsarray
lodgingsarray
productsarrayArray of products passed to AWP
providersarray
rentalCarsarray
treatmentTrackerarray
vehiclesarray