How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Viator Partner Auxiliary API

Supporting reference and content services for the Partner API v2 - free-text search across products, destinations and attractions, bulk location resolution, exchange rates, product reviews, supplier product-code lookup and the destination taxonomy.

Viator Partner Auxiliary API is one of 9 APIs that Viator publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Search, Locations, Reviews, Exchange Rates, and Destinations. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 33 operations across 33 paths, organized into 6 resource areas, and defines 271 schemas. It is described by OpenAPI 3.0.2, at version 2.0.

Requests are made against 2 base URLs: https://api.viator.com/partner, https://api.sandbox.viator.com/partner.

33 operations 33 paths 271 schemas 12 GET21 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2.0
Base URL
https://api.viator.com/partner
Authentication
API Key
License
Resource Areas
6

Authentication & Security 1

Viator Partner Auxiliary API declares 1 security scheme for authenticating requests. An API key is passed in the header as exp-api-key (API-key). By default, every request must be authenticated.

Paths & Operations 33

Across 33 paths, the API surfaces 33 operations — 12 GET, 21 POST. They span 6 resource areas: Products, Auxiliary, Availability, Bookings, Payments, Attractions. Each is listed below with its method, path, parameters, and response codes.

Products 7
GET
/products/modified-since
/products/modified-since
productsModifiedSince 7 params → 200400401403404429500503
POST
/products/bulk
/products/bulk
productsBulk 4 params body → 200400401403404405429500
GET
/products/{product-code}
/products/{product-code}
products 5 params → 200400401403404405429500
GET
/products/tags
/products/tags
productsTags 1 param → 200400401403404429500503
GET
/products/booking-questions
/products/booking-questions
productsBookingQuestions 2 params → 200400401403404429500503
POST
/products/search
/products/search
productsSearch 4 params body → 200400401403405429500503
POST
/products/recommendations
/products/recommendations
productsRecommendations 1 param body → 200400401403404405429500
Auxiliary 6
POST
/search/freetext
/search/freetext
searchFreeText 3 params body → 200400401403404406429500
POST
/locations/bulk
/locations/bulk
locationsBulk 2 params body → 200400401403404429500503
POST
/exchange-rates
/exchange-rates
exchangeRates body → 200400401403429500503
POST
/reviews/product
/reviews/product
reviewsProduct 2 params body → 200400401403404406429500
POST
/suppliers/search/product-codes
/suppliers/search/product-codes
suppliersSearchProductCodes 2 params body → 200400401403404429500503
GET
/destinations
/destinations
destinations 3 params → 200400401403404406429500
Availability 4
POST
/availability/check
/availability/check
availabilityCheck 1 param body → 200400401403404429500503
GET
/availability/schedules/{product-code}
/availability/schedules/{product-code}
availabilitySchedules 2 params → 200400401403404405429500
POST
/availability/schedules/bulk
/availability/schedules/bulk
availabilitySchedulesBulk 1 param body → 200400401403405429500503
GET
/availability/schedules/modified-since
/availability/schedules/modified-since
availabilitySchedulesModifiedSince 4 params → 200400401403429500503
Bookings 13
POST
/bookings/cart/hold
/bookings/cart/hold
bookingsCartHold 2 params body → 200400401403404406429500
POST
/bookings/cart/book
/bookings/cart/book
bookingsCartBook 2 params body → 200400401403404406429500
POST
/bookings/hold
/bookings/hold
bookingsHold 3 params body → 200400401403404406429500
POST
/bookings/book
/bookings/book
bookingsBook 3 params body → 200400401403404406429500
POST
/bookings/status
/bookings/status
bookingsStatus 2 params body → 200400401403404406429500
GET
/bookings/cancel-reasons
/bookings/cancel-reasons
bookingsCancelReasons 3 params → 200401403406429500503
GET
/bookings/{booking-reference}/cancel-quote
/bookings/{booking-reference}/cancel-quote
bookingsCancelQuote 2 params → 200401403404406429500503
POST
/bookings/{booking-reference}/cancel
/bookings/{booking-reference}/cancel
bookingsCancel 3 params body → 200400401403404406429500
GET
/bookings/modified-since
/bookings/modified-since
bookingsModifiedSince 5 params → 200400401403404406429500
POST
/bookings/modified-since/acknowledge
/bookings/modified-since/acknowledge
bookingsModifiedSinceAcknowledge 2 params body → 204400401403404406429500
GET
/amendment/check/{booking-reference}
/amendment/check/{booking-reference}
amendmentCheck 1 param → 200400401403404406429500
POST
/amendment/quote
/amendment/quote
amendmentQuote body → 200400401403404406429500
POST
/amendment/amend/{quote-reference}
/amendment/amend/{quote-reference}
amendmentAmend 1 param → 200400401403404406429500
Payments 1
POST
/v1/checkoutsessions/{sessionToken}/paymentaccounts
/v1/checkoutsessions/{sessionToken}/paymentaccounts
paymentsCreateToken 5 params body → 200404
Attractions 2
POST
/attractions/search
/attractions/search
attractionsSearch 3 params body → 200400401403404405406429
GET
/attractions/{attraction-id}
/attractions/{attraction-id}
attractions 3 params → 200400401403404405406429

Schemas 271

The contract defines 271 schemas that model the data the API accepts and returns. The most detailed are ProductSummary (15 properties), AttractionDetails (14 properties), ProductReview (13 properties), DestinationDetails (12 properties). Each schema is shown below with its type and property counts.

Product
object
5 properties 3 required
TicketType
string
TicketsPerBooking
string
Machine-interpretable value indicating whether each traveler needs their own ticket; one of: - "ONEPERBOOKING" - "ONEPERTRAVELER"
TicketInfo
object
Ticket/voucher details for this product
4 properties 2 required
PricingType
string
Machine-interpretable value specifying whether the pricing for this product is calculated per individual or per group (unit); one of: - "PERPERSON" - "UNIT"
AgeBandType
string
Machine-interpretable value that specifies this age band's type; one of: - "ADULT" - "SENIOR" - "YOUTH" - "CHILD" - "INFANT" - "TRAVELER"
AgeBand
object
Age range categories for this product's ticketing scheme
5 properties
PricingUnitType
string
Machine-interpretable value specifying the type of unit/group when type is "UNIT"; one of: - "BIKE" - "BOAT" - "GROUP" - "PACKAGE" - "ROOM" - "AIRCRAFT" - "VEH…
PricingInfo
object
Ticket/voucher details for this product
3 properties 2 required
ImageSourceType
string
Machine-interpretable value indicating the source of this image; one of: - "SUPPLIERPROVIDED" - "PROFESSIONAL"
ImageVariant
object
3 properties 3 required
Image
object
Image information
4 properties 2 required
StreamingVideoVariant
object
Streaming video variant
3 properties 3 required
ProgressiveVideoVariant
object
Progressive video variant
3 properties 3 required
VideoVariants
object
An object of available video delivery options for the same content, structured by delivery strategy. Each variant defines how the video can be retrieved and pl…
2 properties 2 required
Video
object
Product video
2 properties 1 required
LocationReference
object
Details about the location can be retrieved using the [/locations/bulk](operation/locationsBulk) endpoint
1 property 1 required
StartEndPoint
object
2 properties 1 required
Redemption
object
Redemption point details for this product
3 properties 1 required
PickupOptionType
string
Machine-interpretable value encoding the type of traveler pickup option; one of: - "PICKUPEVERYONE" (the supplier will pick up all customers from their respect…
PickupLocation
object
Pickup or meeting point
2 properties 1 required
TravelerPickup
object
Traveler pickup details for this product
5 properties 2 required
Logistics
object
Logistics details for this product
4 properties 1 required
InclusionExclusionItem
object
7 properties 1 required
AdditionalInfo
object
An additional information fact to communicate to travelers regarding this product
2 properties 1 required
CancellationConditionType
string
Machine-interpretable value encoding the type of cancellation policy for this product; one of: - STANDARD - Products in this category are cancellable up to 24…
CancellationCondition
object
Structured description of fees pertaining to cancellations during various time windows.
5 properties 2 required
CancellationPolicy
object
Cancellation policy details for this product.
5 properties 4 required
BookingCutoffType
string
Machine-interpretable value encoding the type of booking cutoff; one of: - "OPENINGTIME" - "CLOSINGTIME" - "STARTTIME" - "FIXEDTIME"
ConfirmationType
string
Machine-interpretable value encoding when bookings for this product will be confirmed; one of: - "INSTANT" (instantly) - "MANUAL" (requires manual action prior…
BookingConfirmationSettings
object
How this product's bookings are confirmed For more information, see [Booking concepts – Booking cutoff times](section/Booking-concepts/Booking-cutoff-times)
5 properties 2 required
BookingRequirements
object
Passenger type and number requirements for booking
3 properties 3 required
LanguageGuide
object
Specifies which language and what type of language guide to include if language guides are available for this product. Note: This element must be included in o…
3 properties 2 required
Destination
object
Reference details about a destination associated with this product
2 properties 2 required
Itinerary
object
Details about the places this product visits See: [Key concepts – Itineraries](section/Key-concepts/Itineraries) for more information
5 properties 3 required
ItineraryDuration
object
Duration information for this itinerary Note: Depending on whether this itinerary has a fixed or variable duration, this object will include either the fixedVa…
4 properties
ItineraryPoi
object
Details about this Point Of Interest (POI)
2 properties 1 required
AdmissionInclusionType
string
Machine-interpretable value encoding whether the admission fee for this place is included; one of: - "YES" - "NO" - "NOTAPPLICABLE"
StandardItineraryItem
object
5 properties 2 required
StandardItinerary
ActivitiesItineraryItem
object
Location and description of this activity item
2 properties 1 required
ActivityFoodMenu
object
Food menu details for this activity
3 properties 2 required
ActivitiesItinerary
MultiDayTourAccommodation
object
Details for this accommodation venue
2 properties 1 required
MultiDayTourFoodAndDrinks
object
3 properties
MultiDayTourItineraryDay
object
Details about a single day of a multi-day tour
5 properties 2 required
MultiDayTourItinerary
HopOnHopOffStop
object
Place at which passengers can board or alight the tour vehicle
2 properties 1 required
HopOnHopOffItineraryRoute
object
5 properties 3 required
HopOnHopOffItinerary
UnstructuredItinerary
ItineraryType
string
Machine-interpretable value specifying the type of itinerary available for this product; one of: - "STANDARD" - "ACTIVITY" - "MULTIDAYTOUR" - "HOPONHOPOFF" - "…
TravelerPickupProductOption
object
3 properties 2 required
ProductOptionLogistics
object
Logistics details applicable to this specific product option. When present, use this object instead of the product-level logistics object for start and end poi…
3 properties
ProductOption
object
Detail about a single product option for this product
5 properties 2 required
TranslationDetails
object
Information about whether the text in this response was machine-translated
3 properties 2 required
Supplier
object
Supplier details
2 properties 2 required
ProductReviewCount
object
Breakdown of number of reviews for each rating of this product
2 properties 2 required
ProductReviewSource
object
4 properties 2 required
ProductReviews
object
Summary of reviews and ratings for this product Note: - Review data is updated daily; i.e., all reviews received on a day will be added and averages re-calcula…
4 properties 1 required
ViatorUniqueContent
object
Product details unique to Viator.com Note: - Access to this information is only available if it is enabled for your account. Please speak to your account manag…
5 properties
ActiveProduct
InactiveProduct
ProductStatus
string
Machine-interpretable value indicating this product's current availablility; one of: - "ACTIVE" - product is available for sale - "INACTIVE" - product is not a…
ProductsResponse
object
2 properties 1 required
ErrorResponse
object
4 properties
BulkProductRequest
object
1 property 1 required
TagWithAllLocalizations
object
Category/subcategory tag for this product
3 properties 1 required
TagsResponse
object
Numeric product category/subcategory tag identifiers for this product To retrieve details about which tags these identifiers refer to, please use the [/product…
1 property 1 required
BookingQuestionFormatType
string
Machine-interpretable value encoding the required unit type for the answer to the booking question; one of: - "STRING" - "NUMBERANDUNIT" - "DATE" - "TIME" - "L…
BookingQuestionGrouping
string
Machine-interpretable value specifying whether the booking question must be answered individually for each traveler or once per group of travelers in each book…
BookingQuestion
object
A single booking question
10 properties
BookingQuestionsResponse
object
Information about this product's booking questions
1 property 1 required
ProductSearchFlag
string
One of: - "NEWONVIATOR" – products that have been added to Viator's catalogue within the past 270 days - "SKIPTHELINE" – products that allow participants to at…
SearchRatingInfo
object
Only return products that have a rating that is in the range defined here
2 properties
SearchDurationInfo
object
Only return products that have a duration that is in the range defined here.
2 properties
ProductSearchFiltering
object
Only return products that match all the criteria provided here.
12 properties 1 required
ProductSearchSorting
object
How the search results will be sorted
2 properties
ProductSearchPagination
object
Pagination details specifying which search results to return based on start position and item count
2 properties
ProductSearchRequest
object
4 properties 2 required
AvailabilityScheduleSummary
object
Information about the lowest price available for this product Note: The pricing information given here is based on the recommended retail price (RRP). While af…
2 properties 1 required
AvailabilityScheduleExtraChargesSummary
object
Information about the lowest price with extra charges available for this product
3 properties 2 required
ProductSearchPricing
object
High-level summary of product prices - Note: This price may not be available during the date range specified in the filtering section of the request
4 properties 2 required
ProductSummary
object
15 properties 4 required
ProductSearchResponse
object
2 properties 2 required
BulkProductRecommendationsRequest
object
2 properties 2 required
ProductRecommendation
object
2 properties 2 required
FreetextSearchProductFiltering
object
Criteria by which to filter product search results (i.e., when searchTypes includes "PRODUCTS")
8 properties 1 required
FreetextSearchProductSorting
object
Specify the sorting method for product results (i.e., when searchTypes includes "PRODUCTS")
2 properties
SearchType
object
2 properties
FreetextSearchRequest
object
5 properties 3 required
DestinationSearchResult
object
6 properties
ProductReviewsSummaryCount
object
2 properties 2 required
ProductReviewsSummarySource
object
3 properties 2 required
ProductReviewsSummary
object
Summary of reviews and ratings for this attraction Note: - Review data is updated daily; i.e., all reviews received on a day will be added and averages re-calc…
4 properties 1 required
AttractionResult
object
9 properties
FreetextSearchResponse
object
3 properties
PaxMixItem
object
2 properties 2 required
CheckAvailabilityRequest
object
6 properties 4 required
CapacityObject
object
Provides capacity information for the selected bookableItem. Note: Capacity information is not available for all products. The absence of the capacity object o…
1 property
NumberOfTravelers
integer
The number of travelers that this line-item describes the subtotal price for.
RecommendedRetailPrice
number
The recommended retail price for the item and the price at which the product is sold on the Viator.com site
PartnerNetPrice
number
The non-booking fee component of the total amount that Viator will invoice the merchant for this item
PriceObject
object
5 properties 4 required
PriceObjectSubtotal
Components of this price
LineItemPriceObjectSubtotal
object
Subtotal pricing for this line item, including discount information if available
2 properties 1 required
PricingLineItem
object
3 properties 2 required
LineItemPriceObject
object
2 properties 1 required
ExtraChargesItemInDestinationCurrency
object
The Extra Charges amount in destination currency.
3 properties 3 required
ExtraChargesItem
object
List of extra charges. Partners can use this to build a breakdown list of costs.
5 properties 5 required
ExtraChargesSummary
object
Information about the Extra Charges applicable to this bookableItem. Note: - Prices payable to third parties are provided to us by the operator, and may be sub…
3 properties 2 required
CheckAvailabilityBookableItem
object
Details of this bookable item
9 properties 1 required
CheckAvailabilityResponse
object
4 properties 4 required
UnavailableDate
object
2 properties
TimedEntry
object
2 properties 1 required
Special
BasicPriceWithSpecial
Pricing amount information, including 'special' pricing when available. - Note: As the prices listed here may have changed by the time the booking request is m…
1 required
PricingDetails
object
5 properties 1 required
PricingRecord
object
4 properties
OperatingHours
object
2 properties 2 required
DayOperatingHours
object
2 properties 2 required
BookableItemSeason
object
4 properties 1 required
ProductBookableItemSchedule
object
2 properties 1 required
ProductAvailabilitySchedule
object
5 properties 4 required
BulkAvailabilityScheduleRequest
object
1 property 1 required
BulkAvailabilityScheduleResponse
object
1 property 1 required
AvailabilitySchedulesResponse
PartnerCartReference
string
Partner-generated unique cart reference for this group of bookable items.
Currency
string
Merchant Partners: One of USD, EUR, GBP, AUD, CAD Affiliate Partners with API access level "Full Access + Booking": One of USD, EUR, GBP, AUD, CAD, CHF, DKK, F…
PartnerBookingReference
string
Partner-generated unique booking reference for this bookable item.
ProductCode
string
Unique identifier for this product.
ProductOptionCode
string
Product option identifier. For more information see: [Key concepts: Product options](section/Key-concepts/Product-options)
StartTime
string
Starting time for the item in the case that the product/product option has multiple start times. Note: This element must be included for products that have mul…
TravelDate
string
Date of travel (according to the time zone in which the product operates).
AgeBand-2
string
Machine-interpretable value indicating the age-band that this/these traveler(s) fall into; one of: - ADULT - SENIOR - YOUTH - CHILD - INFANT - TRAVELER The val…
PaxMixItem-2
object
2 properties 2 required
BookingsCartHoldRequestItem
object
6 properties 4 required
BookingsCartHoldRequest
CartReference
string
Viator-generated unique reference for this cart of bookable items, e.g.CR-44e4a3f8b65d11edafa10242ac120002
BookingReference
string
Unique Viator-generated booking reference for this bookable item.
BookingHoldStatus
string
The status of this bookable item; one of: - BOOKABLE – This item can currently be booked. Check bookingHoldInfo for availability and pricing hold statuses. - R…
BookingsCartHoldResponseItemBase
object
3 properties 3 required
RecommendedRetailPrice-2
number
The recommended retail price for the item and the price at which the product is sold on the Viator.com site.
PartnerNetPrice-2
number
The non-booking fee component of the amount that Viator will invoice the merchant. For affiliate partners with API access level "Full Access + Booking" this is…
PriceSubtotal
object
2 properties 2 required
PricingLineItemPriceSubtotal
object
2 properties 1 required
PricingLineItem-2
object
3 properties 3 required
CartPrice
object
5 properties 5 required
CartLineItemPrice
object
2 properties 1 required
BookingsCartResponseItemPrice
object
2 properties 2 required
HoldInfo
object
2 properties 1 required
BookingHoldInfo
object
Availability and pricing hold information.
2 properties 2 required
BookingsCartHoldResponseBookableItem
HoldRejectionReasonCode
string
In the case that status is REJECTED, this field provides a code as to the reason for the rejection; one of: - BOOKABLEITEMISNOLONGERAVAILABLE – this bookable i…
BookingsCartHoldResponseRejectedItem
BookingsCartHoldResponse
object
9 properties 5 required
BookerInfo
object
Name details for the person making this booking.
2 properties 2 required
CartBookCommunicationInfo
object
Details for correspondence regarding this booking. See: [Booking concepts – Supplier communications](section/Booking-concepts/Supplier-communications) for info…
2 properties 1 required
VoucherDetails
object
Merchant partners only: Additional details to display on the voucher.
5 properties
FraudPreventionDetails
object
Additional booking details used to enhance fraud detection accuracy. Note: Fraud Prevention Details only apply to affiliate partners with API access level "Ful…
5 properties
LoyaltyProgramDetails
object
Additional booking details used to associate partner's Loyalty Program Information with the booking. Note: This data will be used only by Viator’s internal tea…
3 properties
AdditionalBookingDetails
object
3 properties
BookingQuestionAnswers
object
4 properties 2 required
BookingQuestionAnswers-2
array
Answers to booking questions required for this booking. See: [Booking concepts – Booking questions](section/Booking-concepts/Booking-questions) for more inform…
BookingsCartBookRequestItem
object
3 properties 1 required
BookingsCartBookRequest
object
6 properties 4 required
BookingBookStatus
string
One of: CONFIRMED, PENDING, REJECTED Note: For "PENDING" poll [/booking/status](tag/Bookings/operation/bookingsStatus) for further booking status updates
BookingsCartBookResponseItemBase
object
3 properties 3 required
VoucherFormat
string
File format of the voucher; one of: - PDF - HTML Default is HTML if not specified.
VoucherInfo
object
Voucher information for this booking.
4 properties 3 required
BookingsCartBookResponseConfirmedItem
BookingsCartBookResponsePendingItem
CartBookRejectionReasonCode
string
In the case that status is REJECTED, this field provides a code as to the reason for the rejection; one of: - "BOOKABLEITEMISNOLONGERAVAILABLE" – this bookable…
BookingsCartBookResponseRejectedItem
VoucherInfoCart
object
Voucher information for this booking.
4 properties 3 required
BookingsCartBookResponse
object
7 properties 6 required
BookingRequest
object
6 properties 4 required
BookingHoldRequest
BookingHoldResponse
object
7 properties 2 required
CommunicationInfo
object
Details for correspondence regarding this booking. See: [Booking concepts – Supplier communications](section/Booking-concepts/Supplier-communications) for info…
2 properties 1 required
AdditionalBookingDetails-2
object
Optional extra details to include with booking
1 property
BookingBookRequest
BookingBookResponse
object
9 properties
BookingStatusRequest
object
3 properties
BookingStatusResponseCommon
object
3 properties 2 required
AmendmentStatus
string
Machine-interpretable string indicating the outcome of the booking amendment request. One of: - AMENDED: The amendment was successful - REJECTED: The amendment…
AmendmentRejectionReasonCode
string
Machine-interpretable reason code indicating why the amendment was REJECTED. One of: - "BOOKABLEITEMISNOLONGERAMENDABLE” – this bookable item is no longer elig…
NextPollAt
string
Timestamp (UTC) indicating the recommended time the endpoint should be hit again. Example: "2025-04-03T02:54:29.082753Z"
BookingStatusResponseConfirmed
BookingStatusResponseTransient
BookingStatusResponseRejected
BookingStatusResponseOther
BookingStatusResponse
CancellationReason
object
2 properties
CancellationReasonsResponse
object
1 property
RefundDetails
object
Details of the refund. Note: Bookings that have not been confirmed by the supplier and have a status of "PENDING" will report an itemPrice, refundAmount and re…
4 properties
CancellationQuoteBookingStatus
string
Machine-interpretable string indicating the cancellation status of this itinerary item: - "CANCELLABLE" - this booking is available to be cancelled - "CANCELLE…
CancelBookingQuoteResponse
object
3 properties 2 required
CancellationRequest
object
1 property 1 required
CancellationResultItemReason
string
Machine-interpretable reason code indicating why the cancellation was not successful - "ALREADYCANCELLED": The booking has already been cancelled - "NOTCANCELL…
CancellationBookingStatus
string
Machine-interpretable string indicating the outcome of the booking cancellation request. One of: - "ACCEPTED": The cancellation was successful - "DECLINED": Th…
CancelBookingResponse
object
3 properties 2 required
BookingEventItem
object
4 properties 2 required
BookingEventCancellation
object
2 properties 1 required
BookingEvent
object
9 properties 7 required
BookingsModifiedSinceResponse
object
2 properties 1 required
EventsAcknowledgementRequest
object
1 property 1 required
Address
object
Minimal billing address details for cardholder
2 properties 2 required
CreditCardRequest
object
PCI sensitive details for a debit or credit card and relevant metadata.
6 properties 6 required
PaymentAccountsRequest
object
Wrapper element around payment data.
1 property 1 required
VaultCardRequest
object
The card submission payload.
1 property 1 required
AccountMetaData
object
1 property
CreditCard
object
8 properties 5 required
PaymentAccounts
object
1 property
VaultPaymentResponse
object
1 property 1 required
BulkLocationReferencesRequest
object
1 property 1 required
Location
object
Location detail
2 properties 2 required
LocationAddress
object
Address details for this location
6 properties
LocationCenter
object
Geographic coordinates (latitude/longitude) for this location
2 properties
ResolvedLocation
ProvidedLocation
LocationProvider
string
Name of the location services provider, one of: - "TRIPADVISOR" – location details will be provided in this response - "GOOGLE" – in order to retrieve details…
LocationsResponse
object
1 property 1 required
ExchangeRatesRequest
object
2 properties
ExchangeRateItem
object
5 properties
ExchangeRatesResponse
object
1 property
ProductReviewsRequest
object
8 properties 4 required
ReviewPhoto
object
3 properties 3 required
ReviewPhotoInfo
object
1 property 1 required
ProductReview
object
13 properties 8 required
ProductReviewsResponse
object
3 properties 4 required
BulkSupplierProductRequest
object
1 property 1 required
ContactDetails
object
4 properties
SupplierProductInfo
object
11 properties 4 required
SupplierProductResponse
object
Supplier details for the given product code
1 property 1 required
AttractionsSearchRequest
object
3 properties 1 required
AttractionDetails
object
14 properties 7 required
AttractionsSearchResponse
object
2 properties
DestinationDetails
object
12 properties 7 required
DestinationsResponse
object
2 properties
BookingRef
string
The booking reference code (in format BR-123456789), generated by Viator and returned in the bookingRef element in the response from [/bookings/book](operation…
AmendmentTypes
array
List of booking components that can be amended in this booking: - "BOOKINGDETAILS" - "UPDATEPAXMIX" - "PERTRAVELERQUESTIONS" - "PERBOOKINGQUESTIONS" Notes: - O…
BookingQuestionTraveler
string
Booking question identifier - id field in response from [/products/booking-questions](operation/productsBookingQuestions) endpoint. Possible values: - DATEOFBI…
BookingQuestionUnit
string
Unit in which the answer is provided; one of units in response from [/products/booking-questions](operation/productsBookingQuestions) endpoint.
PaxMixSummary
array
Summary of the current PAX MIX of the booking. It ensures each traveler listed in the PaxMix is assigned a travelerNum and informs which Booking Questions have…
AmendmentCheckResponse
object
5 properties 2 required
AmendmentQuoteRequestCommon
object
1 property 1 required
AmendBookingDetails
object
AmendPaxMix
object
AmendPerTravelerQuestions
object
AmendPerBookingQuestions
object
AmendmentQuoteRequest
object
1 property
QuoteStatus
string
Machine-interpretable string indicating the outcome of the quote request. One of: - CONFIRMED: The quote was successful - REJECTED: The quote was rejected
AmendmentQuoteResponseCommon
object
2 properties 2 required
QuoteReference
string
Unique Viator-generated quote reference for a booking.
QuoteValidUntil
string
Timestamp (UTC) indicating when the quote expires.
QuoteInitialPrice
number
Total price of the booking at the time of purchase.
QuotePriceDifference
object
The price difference that must be paid (or refunded, if negative) to apply the requested amendment to the booking. This value reflects the cost impact of the p…
5 properties 4 required
AmendmentPricingLineItem
object
3 properties 2 required
AmendmentLineItemPriceObject
object
1 property 1 required
QuoteAmendedPrice
object
A detailed breakdown of the total booking price after the requested amendment has been applied.
2 properties 2 required
PaymentMethod
object
Information about the payment method to be used for this transaction. Notes: - The transaction will be processed using the payment method already associated wi…
3 properties 3 required
AmendmentQuoteResponseConfirmed
QuoteRejectionReasonCode
string
Machine-interpretable reason code indicating why the quote was rejected. One of: - "NOAVAILABILITY": This bookable item is not available for the specified comb…
AmendmentQuoteResponseRejected
AmendmentQuoteResponse
AmendmentAmendResponseCommon
object
1 property 1 required
AmendmentAmendResponseInProgress
AmendmentAmendResponseAmended
AmendmentAmendResponseRejected
AmendmentAmendResponse

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

viator-partner-api-v2-openapi.json Raw ↑

Other APIs Viator publishes across the network.

Viator Partner Products API
Viator Partner Availability API
Viator Partner Bookings API
Viator Partner Payments API
Viator Partner Attractions API
Viator Reservation System API
Viator Merchant API v1
Viator Affiliate API v1
Where this information came from

This is an independent, third-party profile of Viator Partner Auxiliary API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.