Viator

Find products that are available This endpoint returns available products filtered by product code, date range or number of adult travelers - Note: Availability data is limited to a period of 12 months into the future from the present time on the production server and 6 months on the sandbox server. Mocked via Mockzilla.

Get the tour-grade with the lowest price that is available for a product on each day of the specified month This service: - returns - useful when displaying a calendar of available tours - For more information, see: Availability services - Notes: - /booking/availability/dates provides all availability in one call and is more suitable for calendars, etc. - Availability data is limited to a period of 12 months into the future from the present time on the production server and 6 months on the sandbox server.

Get dates on which a product is available This service: - retrieves all available dates for a product, excluding days it does not operate and blocked-out dates - returns a multi-dimensional array of year-month -> days that have any availabile tour grade or traveler mix - useful to present the user with a list of dates for selection on which this product is available for booking - Notes: - The user's desired traveler mix may not be eligible for booking; these details can be displayed when you retrieve its list of tour grades - Availability data is limited to a period of 12 months into the future from the present time on the production server and 6 months on the sandbox server.

Get the tour grades of a product that are currently available This service reports: - all tour grades for the specified product, on the specified day, that are available for the specified age bands - the pricing breakdown and the total depending on the travel date and traveler mix Note: Availability data is limited to a period of 12 months into the future from the present time on the production server and 6 months on the sandbox server.

Get a pricing matrix that includes availability and tour-grades for a product Given a month, this service returns days with available tour grades only (i.e., days which have at least one tourgrade available), and the pricing matrix for that tour grade for that day. - Note: Availability data is limited to a period of 12 months into the future from the present time on the production server and 6 months on the sandbox server.

Make a booking For more information, see: - Cancellation policy - Booking concepts - Booking process flow - Making a booking - Supplier communications. Available as a Mockzilla mock endpoint.

Confirm the price of a tour / activity prior to booking For more information, see: Calculating prices - Note: Availability and pricing data is limited to a period of six months into the future from the present time

Get hotel pick-ups Lists the hotel pickups available for either a product or a destination

Get a user's bookings with travel dates in the future. This service can also be used to check the status of a booking. Provide either: - A voucherKey, or... - An email address (email) and a booking reference (itineraryOrItemId) (Booking Reference)

Get the details of a single specific past booking based on the voucherKey or itemId and email address sent in the request. Note: this service will only return past bookings that were made with the same API key that was used to make the booking Sample query parameters: - email=apitest@viator.com&itemId=580669678 or - voucherKey=1005851866:4af44c13ecf3f1a7d3f9ef2fc00c2257e08fa42ae20f877f3039ff9b52aba24e:580669678 email - The email address passed must match the email address associated with the booking Departure details - Departure details such as the departurePoint, departurePointAddress and departurePointDirections is included in the response. - These fields may contain HTML escape characters such as & and special characters that are escaped by a backslash. Ensure that these fields are parsed after receiving the response as it will cause your JSON to be invalid. For more information, see: Reviewing bookings

Get the pricing matrix for tour-grades, product age bands and pax mixes For more information, see: Get the tour-grade pricing matrix. Mockzilla mock: no signup, no API key.

Get the booking status for multiple items based on different criteria This service: - is ideally be used in software for bulk updates of pending bookings - returns a maximum of 1000 bookings (narrow your search if you expect a greater number of results) - will return <u>both</u> live <u>and</u> test bookings - rate limited to <u>one request every 30 minutes</u> - For more information, see: Get the bookiing status for multiple items Exceeding the rate limit - You will receive the following error message if you exceed the rate limit allowed for this service. Set test to true to bypass this limit: { "data": null "vmid": 221002 "errorMessage": ["Access allowed every 30 minutes"] "errorType": "EXCEPTION" "dateStamp": "2013-03-26T10:28:51+0000" "errorReference": 55315512721712161381352771 "errorMessageText": ["Access allowed every 30 minutes"] "success": false "totalCount": 1 "errorName": "PollingDeniedException" }

Get brief booking statuses This service is similar to /booking/status in that it: - retrieves the booking status for multiple items based on different criteria - has the same request parameters as /booking/status However, it differs in that it returns a multi-item array of booking items with less detail than what would be received from /booking/status.

Get voucher details - Use this service to retrieve the voucher details of a booked item. - The data returned is HTML-formatted and can be wrapped in a header and/or footer. Sample query parameters - leadLastName=Simpson test&itemId=580669678 or - voucherKey=1005851866:4af44c13ecf3f1a7d3f9ef2fc00c2257e08fa42ae20f877f3039ff9b52aba24e:580669678&fullHTML=true&mobileVoucher=true

Retrieves a dictionary of unique identification codes (cancellationReasonCode) and their associated natural-language descriptions (cancellationReasonText). For information on how to use this service, see: Cancellation API workflow Note: This service <u>requires</u> exp-api-key to be included as a header parameter. Please speak to your account manager if you have not yet been issued an exp-api-key. The base URL for the server for this endpoint is different from the older endpoints described in this document. Use https://api.sandbox.viator.com/partner/cancel-reasons

Submits a cancellation request for the specified booking For information on how to use this service, see: Cancellation API workflow Note: This service <u>requires</u> exp-api-key to be included as a header parameter. Please speak to your account manager if you have not yet been issued an exp-api-key. The base URL for the server for this endpoint is different from the older endpoints described in this document. Use https://api.sandbox.viator.com/partner/bookings/{booking-reference}/cancel. Served by the Mockzilla mock runtime.

Retrieves a quote for the cancellation of a booking For information on how to use this service, see: Cancellation API workflow Note: This service <u>requires</u> exp-api-key to be included as a header parameter. Please speak to your account manager if you have not yet been issued an exp-api-key. The base URL for the server for this endpoint is different from the older endpoints described in this document. Use https://api.sandbox.viator.com/partner/bookings/{booking-reference}/cancel-quote

Health check Use this service to determine whether the Viator API is presently online and that your API key is valid. You should receive a response identical to the example shown. If you have not yet received an API key, please request one from your business development partner. If you have not yet signed up as a Viator merchant partner and would like to, please visit our distribution partner website."

Cancel a booking Note: This service has been replaced by the cancellationReasons, bookingQuote and cancelBooking endpoints

Get product information This service provides all product details required for a product display page, as well as information required for price checks and booking, such as: - age bands - tour grades - language options - booking questions - hotel pickup flags currencyCode (in query): - use this parameter to specify the currency in which product pricing should be displayed - the default currency is the currency of your account; or, if you have multi-currency enabled, US dollars - "multi-currency" allows pricing and booking in various currencies - please speak to the business development team if you'd like this enabled - Note: you will be billed in the currency in which the booking was made Product photos <mark><u>Update 13 Feb 2020</u>: All supplier-provided photos for the selected product are now available in the productPhotos array in this endpoint's response. Previously, only two supplier-provided photos were available – one in the productPhotos array and one in thumbnailHiResURL. </mark> Videos - Videos are no longer provided via this API

Get photos of a product submitted by users. Mocked via Mockzilla.

Get user-submitted reviews of a product Note: - The number of reviews that you can obtain via this service will depend on whether your account is limited in terms of the number of reviews you are entitled to receive. - The number of reviews available through this service is given in the reviewCount element in the response from /product - Please speak to your account manager if you wish to receive more reviews. If your account is not limited, you will be able to receive all available reviews for this product. - Only reviews in the language specified in the Accept-Language request header will be returned Example: "Get the first three reviews for product 5010SYDNEY sorted by rating in ascending order": https://viatorapi.sandbox.viator.com/service/product/reviews?sortOrder=REVIEW_RATING_A&topX=1-3&code=5010SYDNEY&showUnavailable=false

Free text search - This service provides a free text search across all products and destinations - The text parameter is required - Note: results include a type indicator (type) that you can use to display each result appropriately based on its content

Search for products This service is used to search for products based on various criteria; such as: the destination (locale) in which it operates its association with a tourist attraction its category and/or subcategory the time period during which it operates The fields you include in the request body for this service determine the kind of search that will be performed. <u>Note</u>: You can search EITHER by destination (destId) OR by attraction-link (seoId), but not both. The destination identifier (destId) can be retrieved from the /taxonomy/destinations service. The category (catId) and subcategory (subCatId) identifiers can be retrieved from the /taxonomy/categories service. The attraction identifier (seoId) can be retrieved from the /taxonomy/attractions service. <u>Examples</u>: Search by destination: E.g., "Top ten highest-rated yoga classes operating in Las Vegas: { "destId": 684, "subCatId": 26052, "sortOrder": "REVIEW_AVG_RATING_D", "topX": "1-3" } Search by attraction-link: E.g., "Products related to Everglades National Park operating 21-26 May 2019 in order of descending price": { "seoId": 1115, "sortOrder": "PRICE_FROM_D", "topX": "1-3" } <u>'Freesale-only' merchants</u>: - Merchants with a "freesale only" key must pass startDate and endDate to this service to retrieve a list of all available 'freesale' products (and 'freesale/on-request' products that are currently 'freesale') in the destination. - E.g., the following request body will result in 'freesale/on-request' products within their on-request period not appearing in the results from this service. { "destId": 684, "startDate": "2020-02-21", "endDate": "2020-03-21", "sortOrder": "PRICE_FROM_D", "topX": "1-3" } - If startDate and endDate are omitted, 'freesale/on-request' products that are presently within their on-request period may appear to be available to customers, but won't be available at the time of booking.

Search by product code - This service returns an array of products given an array of product identifiers that is useful for wishlist / shopping cart / user account display - Note: requesting an inactive or non-existent product code will return 0, null and blank values (as per the 'invalid_product' example).

Get attractions - Retrieves a list of attractions (things like the Eiffel Tower or Empire State Building) and their associated unique numeric identifiers - The attraction's identifier (seoId) can be used as a means of searching for available products; for example, in the /search/products service. Available as a Mockzilla mock endpoint.

Get all product categories - Retrieves a list of product categories for a destination that can be used as a means of filtering when searching for products using the /search/products service - This service can be used to get a list of all categories and subcategories for a destination by including its destId, or you can omit the destId to get a list of all categories and subcategories - Note: If no destId is passed, productCount and thumbnailURL will be null as they are destination-specific fields

Get details of all destinations supported by this API - Retrieves all the country taxonomy/city nodes as a flat list - Returns a complete list of Viator destinations, including destination names and parent identifiers - Used to provide navigation through drill down lists or combo boxes