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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Viator

Viator Booking services API

Booking services

Documentation Provider Profile APIs.io OpenAPI GitHub

Viator Booking services API is one of 17 APIs that Viator publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Booking services. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 16 operations across 16 paths, and defines 18 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://viatorapi.viator.com/service, https://viatorapi.sandbox.viator.com/service.

16 operations 16 paths 18 schemas 7 GET9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.viator.com/partner
Authentication
API Key, API Key
Contact
Viator Partner Support Team
License
CC BY 4.0
Resource Areas
1

Authentication & Security 2

Viator Booking services API declares 2 security schemes for authenticating requests. An API key is passed in the header as exp-api-key (API-key). An API key is passed in the query as apiKey (Legacy-API-key). By default, every request must be authenticated.

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 7 GET, 9 POST. Each is listed below with its method, path, parameters, and response codes.

Booking services 16

Booking services

POST
/booking/availability
/booking/availability
bookingAvailability 1 param body → 200
GET
/booking/availability/dates
/booking/availability/dates
bookingAvailabilityDates 2 params → 200
POST
/booking/availability/tourgrades
/booking/availability/tourgrades
bookingAvailabilityTourgrades 1 param body → 200
POST
/booking/availability/tourgrades/pricingmatrix
/booking/availability/tourgrades/pricingmatrix
bookingAvailabilityTourgradesPricingmatrix 1 param body → 200
POST
/booking/calculateprice
/booking/calculateprice
bookingCalculateprice 1 param body → 200
GET
/booking/hotels
/booking/hotels
bookingHotels 3 params → 200
POST
/booking/book
/booking/book
bookingBook 1 param body → 200
POST
/booking/status
/booking/status
bookingStatus 1 param body → 200
POST
/booking/status/items
/booking/status/items
bookingStatusItems 1 param body → 200
POST
/booking/pricingmatrix
/booking/pricingmatrix
bookingPricingmatrix 1 param body → 200
GET
/booking/voucher
/booking/voucher
bookingVoucher 7 params → 200
GET
/booking/pastbooking
/booking/pastbooking
bookingPastbooking 4 params → 200
GET
/booking/mybookings
/booking/mybookings
bookingMybookings 4 params → 200
GET
/bookings/cancel-reasons
/bookings/cancel-reasons
cancellationReasons 1 param → 200401406500503
GET
/bookings/{booking-reference}/cancel-quote
/bookings/{booking-reference}/cancel-quote
cancelBookingQuote 1 param → 200401406500503
POST
/bookings/{booking-reference}/cancel
/bookings/{booking-reference}/cancel
cancelBooking 2 params body → 200400401404406500503

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are basicErrorModel (12 properties), bookingStatus_item (9 properties), bookingStatus_itinerary (9 properties), 401_UNAUTHORIZED (4 properties). Each schema is shown below with its type and property counts.

406_NOT_ACCEPTABLE
object
4 properties
bookingEngineId-response
string
[booking type indicator](section/Key-concepts/Booking-concepts) that indicates whether the booking will be CONFIRMED immediately or if it will remain PENDING e…
basicErrorModel
object
12 properties
CancellationReasonsResponse
object
1 property
CancelBookingQuoteResponse
object
3 properties
503_SERVICE_UNAVAILABLE
object
4 properties
500_INTERNAL_SERVER_ERROR
object
4 properties
CancelBookingResponse
object
3 properties
CancellationReason
object
2 properties
CancellationRequest
object
1 property
ageBandId
integer
unique numeric identifier for the age band - See: [Working with age bands](section/Appendices/Working-with-age-bands)
savingAmountFormated
string
Ignore (Viator only)
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 ref…
4 properties
bandId
integer
unique numeric identifier for the age band - See: [Working with age bands](section/Appendices/Working-with-age-bands)
savingAmount
string
Ignore (Viator only)
401_UNAUTHORIZED
object
4 properties
bookingStatus_item
object
object containing item booking status information
9 properties
bookingStatus_itinerary
object
object containing itinerary booking status information
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

viator-booking-services-api-openapi.yml Raw ↑

Other APIs Viator publishes across the network.

Viator Attraction services API
AE Profile APIs.io
Viator Attractions API
AE Profile APIs.io
Viator Auxiliary API
AE Profile APIs.io
Viator Availability API
AE Profile APIs.io
Viator Bookings API
AE Profile APIs.io
Viator Deprecated API
AE Profile APIs.io
Viator Deprecated services API
AE Profile APIs.io
Viator General services API
AE Profile APIs.io
Viator Payments API
AE Profile APIs.io
Viator Product services API
AE Profile APIs.io
Viator Products API
AE Profile APIs.io
Viator Reservation system APIs API
AE Profile APIs.io
#Booking services
← Back to V APIs
API Details
ID
viator:viator-booking-services-api
Base URL
https://api.viator.com/partner
Docs
https://docs.viator.com/partner-api/technical/
Provider
Viator
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=viator-booking-services-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/viator-booking-services-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Viator Booking services 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.