All API integrations Bokun API

Bokun API Integration

We build and maintain Bokun integrations in production — inventory-service plugins, product and rate sync, availability feeds, and booking flows — and we host and monitor what we build.

Overview

What the Bokun API actually gives you.

Bokun (Bókun) is the booking and channel-management platform for tours, activities, and attractions, part of the Tripadvisor group. Operators use it to hold their products, rates, and availability in one place, sell directly through its booking engine, and distribute the same inventory out to OTAs and to its B2B marketplace.

The Bokun API is how you connect your own systems to that: read and write products, pull availability, create and cancel bookings, and — if you are the one holding the inventory — serve availability and pricing back to Bokun as a channel manager. It is a capable API with a lot of surface area. Most of the cost in a Bokun project is not writing the first request — it is the mapping, the edge cases, and making sure the thing keeps working once nobody is watching it.

Capabilities

The parts you will actually use.

  • Products & rates — read an experience with its start times, rates, and pricing categories, search the catalogue, and create experiences programmatically.
  • Availability — bookable slots across a date range, with the identifiers and per-rate prices needed to place a booking.
  • Bookings — reserve, confirm, and cancel, with the various checkout and payment options the platform supports, plus ticket and voucher retrieval.
  • Configuration — booking cutoffs, pricing, and product settings, readable and writable so your own system can keep them correct.
  • Distribution — connect an inventory service so Bokun asks your system for availability and pricing, and sends bookings and cancellations back to you.
  • Webhooks & reporting — booking events out to your CRM, accounting, or notification stack, and booking data for reconciliation.
Scope

Where these projects actually get hard.

Reading the documentation is the easy half. These are the areas that decide whether an integration takes weeks or months — and the ones we scope carefully before quoting.

  • Rate and option mapping. Two systems almost never model rates, options, and pricing categories the same way. Getting the mapping exactly right is most of the project, and a wrong mapping tends to fail quietly rather than throw an error.
  • Write semantics. Not every write behaves like a simple field update, and the difference matters a great deal when the target is live pricing on sellable inventory. Knowing which writes are safe to make, and in what order, is learned on real accounts.
  • Reporting fields. Several fields do not mean quite what their names suggest. Revenue and margin reporting built on the obvious ones tends not to reconcile against what was actually invoiced.
  • Dates and time zones. A booking date and a local departure time are not the same thing, and conflating them is the single most common source of off-by-one-day bugs in travel reporting.
  • Booking lifecycle. Amendments and cancellations have to propagate in both directions. If they do not, you end up holding supplier reservations against bookings that no longer exist — which costs real money before anyone notices.
  • Permissions and ownership. Some operations are refused for account-level reasons rather than anything wrong with your request. Recognising those quickly saves days of debugging the wrong layer.
  • Silent failure. A 200 response does not mean the thing you intended happened. Integrations need health checks and reconciliation against money, not just successful HTTP calls.
Channel management

Reading from the platform vs. being the inventory.

There are two ways to be on the other side of Bokun. If Bokun is the system of record, you read from it and write to it over REST. If your system holds the inventory, you implement an inventory service — a channel-manager plugin that Bokun calls for availability and pricing, and notifies when a booking is made or cancelled.

The second is where the real engineering is. Bokun calls your endpoint on its own schedule and expects fast, correct answers; the mapping between its rate structure and yours has to be exact; and the booking lifecycle has to stay consistent on both sides. We have built and operated this layer in production, which is a different thing from having read the specification.

What we build

Work we take on.

  • Inventory-service / channel-manager plugins — your inventory served to Bokun, with availability, pricing, booking create, and cancel propagation.
  • Platform-to-platform bridges — Bokun to another reservation system, or Bokun to Bokun between tenants, keeping products, rates, and bookings in step.
  • Product & rate sync — catalogue, start times, and pricing kept aligned between Bokun and your source of truth, with the write semantics handled safely.
  • OTA distribution — getting inventory out through Bokun to the OTAs and marketplaces it connects to, and fixing mappings when rate structures do not line up.
  • Booking automation — webhooks into accounting, helpdesk, CRM, or notifications; voucher and ticket retrieval; automated cancellation handling.
  • Reconciliation & reporting — OTA payouts against Bokun bookings and supplier invoices, with the double-count and zero-price traps above designed out.
FAQ

Common questions

Is the Bokun API free to use?

API access comes with a Bokun account rather than as a separate product. You generate an access key and secret in the account settings, and each request is signed. What you can reach depends on the permissions of the account the keys belong to — vendor, reseller, and marketplace roles see different things, which is a common source of confusing 403s and empty results early in a project.

Can I push my own availability and pricing into Bokun?

Yes, in two different ways. You can write products, rates, and pricing over the REST API so Bokun holds the data. Or, if your own system is the source of truth, you implement an inventory service and Bokun asks you for availability and pricing in real time. The first suits a catalogue that changes occasionally; the second is what you need when availability is live.

What is the difference between the Bokun API and the Bokun channel manager?

The API is the interface you call. The channel manager is the distribution function — one set of inventory, many sales channels, without overselling. You can use the API without touching distribution, and you can distribute through Bokun without writing code. Connecting your own inventory as a channel is where the two meet, and that is an inventory-service plugin.

How long does a Bokun integration take?

A read-only sync — pull products, availability, and bookings into your own system — is usually a short piece of work. A full inventory-service plugin with pricing, booking creation, and two-way cancellation is a longer build, and the time goes into mapping and edge cases rather than the happy path. We will give you a scoped estimate once we have seen the account and what it has to talk to.

Do you work with both the v1 and v2 Bokun APIs?

Yes, and most real integrations need both. The two generations cover different ground, and a given field is often readable from one and writable only from the other. Knowing which is which up front saves a great deal of time.

Can you take over an integration someone else built?

Yes. A lot of what we are asked to do is repair: mappings that no longer line up, cancellations that do not propagate, reports that do not reconcile, a plugin that goes quiet with no health check in front of it. We will tell you honestly whether it is cheaper to fix or to rebuild.

Need a Bokun integration built, fixed, or taken over?

Get in touch