Dispatch

Dispatch

How trips are matched and offered to drivers

Dispatch decides which driver gets each trip and how the offer is made. Allocation is configurable — offers and queues, open auto-assign, zone rules — with automated recovery when a trip struggles for a car, and a full audit of every decision.

• Configurable allocation

  Offer-and-accept or direct assignment, ordered by your queues, with a search radius that widens the longer a trip waits.

• Zone-aware

  Tenant-defined zones drive candidate selection and queue entry, with backup zones and per-zone fallback when supply runs dry.

• Automated rescue & audit

  At-risk trips are promoted for targeted rescue offers, and every dispatch sweep decision is recorded for review.

How a driver is chosen

Default candidate scoring weights — tunable per fleet

• Distance50%
• Earnings fairness25%
• Idle time15%
• Heading10%

Balanced, not greedy — the nearest car isn't always the one offered.

API reference 45 operations · interactive — try them against the sandbox

→

13 features in Dispatch

Automated Rescue Designation

When a trip is flagged as at-risk (low supply / approaching cutoff / capacity-gated), dispatch promotes it to a manual d

Backup Queues

When a feeder queue's drivers can't cover a trip, its BackupQueueGroups widen the trip's eligibility pool over time — ea

Backup Zones

When a primary zone has no driver supply, dispatch can fall back to a BackupZoneGroup — an ordered list of feeder zones

Designated Transporters

Operators can manually assign a trip to a specific transporter, bypassing the normal dispatch flow

Dispatch Audit Logging

Records every dispatch sweep decision (candidates evaluated, scores, exclusions, offers created/rejected/expired) into a

Dispatch Offers

A time-limited, one-to-one binding between a trip and a candidate driver

Dispatch Zones

A Zone is a tenant-defined geographic area used by the dispatch engine

Driver Queues

Queues are ordered driver lists scoped to one or more zones

Expanding Proximity Radius

The single place dispatch decides how wide to search for a candidate driver

Open Dispatch

Dispatch mode where eligible drivers receive direct trip assignments instead of offers — no accept/reject loop, no expir

Pre-booking Staging

Driver-self-service staging window before a pre-booked trip enters auto-dispatch

STC Dispatch (Soon-to-Clear)

Makes WORKING transporters dispatch-eligible when they are close enough to their final drop-off that they can plausibly

Zone Fallback Policy

Per-zone overrides for how dispatch falls back when supply is short