Important Network Notice: We are a fully independent nationwide transport operator based in Helensburgh, Scotland. We are not related to any closed, London-only booking systems or alternative .co.uk platforms. Our live cross-border driver app framework is powered by Trident Taxis.

NPT Taxi
Book now

National Taxis developer documentation

How the National Taxis booking engine prices and dispatches a ride, how the flat weekly driver subscription is billed, and the public REST endpoints you can call to quote, book and track journeys.

Base URL. https://nationaltaxinetwork.app — every connected domain also serves the same API and is listed in the OpenAPI spec at /api/public/openapi.json. Related reading: platform architecture and the MCP tools reference.

1. Booking engine flow

A journey moves through four deterministic stages. Each stage is idempotent, so a retried request never creates a duplicate ride.

  1. Quote. Pickup, dropoff, passenger count and vehicle class are priced against council tariffs or an approved driver/partner rate override. The returned quote is fixed and valid for 24 hours.
  2. Book. The quote is redeemed once, with passenger contact details, into a live booking with a public reference.
  3. Dispatch. The booking is matched to the LocalDriver App pool — local drivers first, then national network drivers, then approved partner fleets — filtered by availability, seat capacity, vehicle class and accessibility. The winner receives an SMS/WhatsApp job card.
  4. Track and settle. Status updates stream to the passenger tracking page, and the fare is paid directly to the driver.

2. Public API endpoints

  • POST/api/public/v1/quote

    Price a journey and return a fixed fare with a redeemable quote_id.

  • POST/api/public/quotes/estimate

    GPT-friendly alias of the quote endpoint, matching the published OpenAPI schema.

  • POST/api/public/v1/booking

    Redeem a quote into a live, auto-dispatched booking. Returns the booking reference plus tracking and payment URLs.

  • POST/api/public/bookings/create

    Alias of the booking endpoint for agent integrations.

  • GET/api/public/v1/booking/{ref}

    Read the current status, pickup time, assigned driver and payment state of a booking.

  • GET/api/public/v1/jobs

    Driver-scoped feed of offered and accepted jobs for LocalDriver App clients.

  • POST/api/public/v1/passenger-verify

    Verify a passenger email before a booking is accepted, blocking disposable addresses.

  • GET/api/public/openapi.json

    Machine-readable OpenAPI 3 description of the whole public surface.

3. Authentication and limits

Send your API key as X-National-Taxi-AI-Key, Authorization: Bearer <key>, or x-api-key. Requests are rate limited per key and per IP, logged, and screened for prompt-injection content before reaching the booking engine. Supplier webhooks (CMAC, Minicabit) authenticate instead with a per-supplier shared secret or HMAC signature.

curl -X POST https://nationaltaxinetwork.app/api/public/v1/quote \
  -H "Content-Type: application/json" \
  -H "X-National-Taxi-AI-Key: $NT_API_KEY" \
  -d '{
    "pickup": "Glasgow Airport",
    "dropoff": "Helensburgh",
    "passengers": 2,
    "vehicle_type": "saloon"
  }'
curl -X POST https://nationaltaxinetwork.app/api/public/v1/booking \
  -H "Content-Type: application/json" \
  -H "X-National-Taxi-AI-Key: $NT_API_KEY" \
  -d '{
    "quote_id": "qt_...",
    "passenger_name": "Jane Doe",
    "passenger_email": "jane@example.com",
    "passenger_phone": "+447700900123",
    "payment_method": "direct_to_driver"
  }'

4. Driver subscription flow

Drivers are billed a flat weekly software subscription instead of a per-ride commission, so 100% of every fare goes straight to the licensed driver.

  1. Sign up and approval. A driver applies, uploads licensing details, and is approved by an operator before jobs are offered.
  2. Free trial. New drivers start on a 90-day free trial; partners start on a 30-day trial, extendable by an administrator.
  3. Earnings threshold. The £20 weekly fee only applies once weekly earnings pass £500. Below that, the week is free.
  4. Billing. A weekly invoice is generated and charged; paid weeks are tracked on the driver dashboard alongside earnings, completed rides and dead mileage.
  5. Pass-through costs only. Beyond the flat fee, the platform passes through card-processing fees, £0.02 per SMS and Onde-originated job fees. Email, WhatsApp and cash bookings are free, and high-volume drivers supply their own Google Maps API key billed directly by Google.

Subscription state, trial days remaining and completed rides are visible in the driver app and summarised publicly on the driver fees page.

5. Inbound job webhooks

Aggregators and corporate suppliers push jobs straight into live dispatch. Each request is authenticated, idempotent by job reference, and supports new, amend and cancel events.

  • POST/api/public/hooks/cmac-booking

    CMAC supplier job intake, authenticated with x-cmac-secret.

  • POST/api/public/hooks/minicabit-booking

    Minicabit job intake, single or batch payloads, HMAC or shared-secret authenticated.

  • POST/api/public/hooks/booking-status

    Signed status fanout so partner platforms stay in sync with local booking state.