DMM LIVE INTEGRATION API

AI Telephone Job Booking API

OpenAPI-compatible interface for Jobix or another approved AI telephone / automation partner. Base URL: https://dmm.aigoat.uk/api/v1

Download / view OpenAPI 3.1 JSON

Authentication

Protected endpoints require a DMM-generated integration API key:

X-API-Key: YOUR_DMM_INTEGRATION_KEY

Generate/rotate the key from DMM → Wishlist → AI Telephone Booking API. DMM stores only a SHA-256 hash; the full key is shown once. Do not send Supabase keys or DMM user passwords to integration providers.

Endpoints

GET/healthPublic service status.

GET/openapi.jsonPublic OpenAPI definition.

GET/catalogProducts, groups, units, categories, required-data rules and selected settings.

GET/customers/search?q=07700...Find an active customer by phone, postcode, contact or business name.

GET/availability?date=2026-08-24&time=09:30&durationHours=1Returns only drivers and trucks free for the full requested time window, plus bookable driver/truck pairs.

POST/bookingsCreate a live Planner Job when Driver + Truck are available. If not, automatically returns QUOTE_CREATED and saves the enquiry for office follow-up.

POST/quotesExplicitly create a DMM Quote / lead for office follow-up.

GET/bookings/{id}Read the live booking confirmation.

Example booking

{
  "provider": "Jobix",
  "externalReference": "call_123456",
  "customerId": "existing-customer-uuid",
  "date": "2026-08-24",
  "time": "09:30",
  "durationHours": 1,
  "driverId": "driver-id",
  "truckId": "truck-id",
  "paymentType": "CARD",
  "customerReference": "PO-7781",
  "delivery": {
    "mode": "different",
    "address1": "1 Example Road",
    "town": "Poole",
    "postcode": "BH15 1AA"
  },
  "items": [
    { "productId": "product-id", "quantity": 1 }
  ],
  "requiredDataAnswers": []
}

Resource safety + lead retention

The API checks the selected driver and truck for time overlap when availability is requested, then checks both resources again immediately before the booking is written. If either resource cannot be confirmed, DMM does not lose the caller: POST /bookings returns QUOTE_CREATED and saves the full enquiry into Quotes for office follow-up.

Audit behaviour

API-created Jobs are stamped with the integration provider, external reference, request ID, creation timestamp and source: AI Telephone. The third party never receives direct database credentials.