Skip to content

Getting started with the Booking.com Taxi Supplier API

The Booking.com Taxi Supplier Public API allows our supply partners to provide prices for journeys, accept bookings, reject bookings and send driver events to keep customers up to date at pickup time.

Quick Start

  1. Authenticate — Obtain an OAuth 2.0 access token
  2. Retrieve Bookings — Fetch your allocated bookings
  3. Accept or Reject — Respond to each booking
  4. Assign a Driver — Provide driver and vehicle details
  5. Send Driver Events — Keep customers updated during the journey

Our APIs

Feature Description Documentation
Sandbox Test your integration before going live Getting Started
Authentication OAuth 2.0 for API access Getting Started
Booking Management View, accept & reject bookings Getting Started
Meeting Points Share pickup instructions with customers Getting Started
Driver Management Manage & assign drivers, send driver events Getting Started
Webhooks Provide prices and receive real-time notifications Getting Started
Surveys Retrieve customer feedback data Getting Started
Incidents Access complaint and incident data Getting Started

Base URLs

Environment Auth URL API URL
Production https://auth.dispatchapi.taxi.booking.com https://dispatchapi.taxi.booking.com
Sandbox https://dispatchapi-sandbox-qa.auth.eu-west-1.amazoncognito.com/oauth2/token https://dispatch-api-sandbox.qa.someonedrive.me

Authentication Direction

There are two authentication flows — one for calling the API, and one for receiving webhooks:

┌─────────────────────────────────────────────────────────────────────┐
│  YOU calling Booking.com (API endpoints)                            │
│                                                                     │
│  Your System ──── POST /oauth2/token ────► Auth URL                 │
│       │           (Basic: your clientId:clientSecret)                │
│       │                                                             │
│       └────────── GET /v1/bookings ──────► API URL                  │
│                   (Authorization: <JWT token>)                       │
└─────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────┐
│  Booking.com calling YOU (webhooks)                                  │
│                                                                     │
│  Booking.com ──── POST /oauth/token ─────► Your Auth Endpoint       │
│       │           (Basic: credentials you gave us)                   │
│       │                                                             │
│       └────────── POST /v2/search-results ► Your Webhook Endpoint   │
│                   (Authorization: <token from your endpoint>)        │
└─────────────────────────────────────────────────────────────────────┘

Feature Tiers

Foundational (essential to manage bookings)

Feature Article Documentation
Booking Management (V1) Help Centre Docs
Driver Assignment (V2) Help Centre Docs
Driver Events Help Centre Docs

Experience (improve conversion and productivity)

Feature Article Documentation
Search Webhook (API Pricing) Help Centre Docs
Pickup Instructions with Images Help Centre Docs
Survey API Help Centre Docs
Incident API Help Centre Docs

Advanced (maximize efficiency)

Feature Article Documentation
Booking Webhook Help Centre Docs
Full GPS Tracking Help Centre Docs
Genius Discounts Help Centre Docs