API Docs
Dashboard

Destination Tools API

Book chauffeur trips, manage your fleet and drivers, read quotes and invoices, and drive dispatch — directly from your own software.

Base URL — all endpoints live under https://app.destination.dev/api/v1 and return JSON.

How it works

The API is a versioned REST interface. Authenticate with a Bearer token — a per-business API key or a per-user access token — call resource endpoints, and receive a consistent response envelope. Every response carries a meta.request_id you can quote in support requests.

A first request

List the trips on your dispatch board:

Request

curl https://app.destination.dev/api/v1/trips \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "trip_id": 4821,
      "business_id": 7,
      "trip_type": "transfer",
      "status": "confirmed",
      "payment_status": "paid",
      "customer_id": 219,
      "customer_name": "Aoife Byrne",
      "trip_date": 1785148251,
      "pickup_address": "Dublin Airport T2, Dublin",
      "dropoff_address": "The Shelbourne, Dublin 2",
      "participants_count": 2,
      "car_id": 12,
      "total_amount": 85.00,
      "currency": "EUR",
      "invoice_id": 61,
      "invoice_ids": [61]
    }
  ],
  "meta": {
    "request_id": "req_1a2b3c4d5e6f7a8b",
    "pagination": {
      "page": 1, "per_page": 20,
      "count": 1, "total": 1,
      "total_pages": 1, "has_more": false
    }
  }
}

Resources

Each endpoint is labelled with a status: Live available now · Beta available, may change · Planned documented, not yet released.

ResourceWhat you can doStatus
Trips List, create, update and delete chauffeur trips — the core transport resource, with pickup, drop-off, passengers, vehicle and driver. Each trip carries the customer it belongs to and the invoices it is billed on. Live
Cars List, create, update and delete the vehicles in your fleet. Live
Drivers List, create, update and delete drivers, and see which cars they can drive. Live
Products List, create, update and delete the packages you sell, and upload cover images. Live
Customers List, search, create and update your customer directory, and read a customer's trip and invoice history. Live
Quotes Full quote authoring — create, edit and delete quotes, add and price individual legs, then send, accept, reject or convert them. Live
Invoices List, create, update and delete invoices with line items; attach and detach trips, assign a customer, record payments, email them out, download the PDF and read stats. Live
Payments Take a cash payment, issue a refund, generate a balance payment link and read a trip's payment summary. Live
Dispatch A dispatch-optimised trip feed, driver assignment, live driver and trip locations, and fare calculation. Live
Driver app Per-assignment token endpoints a driver's device uses to read its job and report location and status. Live
Settings Read and update the business profile, and check which integrations are connected. Live
Account Log in, refresh and revoke tokens, read and edit your own profile, and manage API keys. Live
Devices Register and unregister device tokens so a native app can receive push notifications. Live
Uploads Upload a file and receive a hosted URL to attach elsewhere. Live
Webhooks Register endpoints to receive signed, retried trip, quote, invoice and payment events. Beta
Admin Platform administration across every business — super-admin tokens only. Live

Next steps