Skip to content

Trip

Trip

The booking, from request to completion

A trip carries the booking through its lifecycle — scheduled or ASAP, single or multi-load, one-off or recurring — and is continuously watched for trouble so a problem is caught while it's still small.

Lifecycle & scheduling
Segments, stops and units of work move through a clear state machine; trips can be pre-booked, scheduled with release timing, or repeated on a recurring schedule.
Trip health
Every active trip is monitored for late prediction, stale GPS, allocation risk and more — surfaced to the operator, or resolved automatically when you allow it.
Multi-load & merging
Compatible trips can be combined into shared rides within configurable time, distance and capacity limits.

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

44 features in Trip

Pre-flight checks that block a driver from marking a stop as arrived / finished when real-world conditions are not met —

Cargo Model (Package) coming soon

Models the cargo itself — a Package with weight/volume/dimensions, tracking codes, plain recipient contact fields (no Cu

Delivery Daily Planner coming soon

Batch-plans the day's pending PACKAGE segments into sequenced van-day routes respecting time windows and weight/volume/d

Delivery Mode coming soon

A logistics/delivery operating mode alongside taxi/people-movement, built by extending the existing Trip spine rather th

Health Auto Resolve

Baseline-driven health resolution engine (ported from the decommissioned go-agent)

Late-Cancellation Penalty

Customer-fault miles penalty when a customer cancels late: a no-show penalty if the driver had already arrived, otherwis

Multi-Load Trips

A single Trip can carry multiple chained segments (multi-load), enabling shared-ride, ride-pool, and school-run patterns

Compliance chain a driver must satisfy before a stop can be marked no-show: must be near the pickup, must have waited th

Operator Notification Badges

Single lightweight endpoint that returns badge counts for every notification source the operator console renders — healt

Optimizer Fleet Scheduling coming soon

A planned extension that moves the optimiser from combining trips to assigning them — allocating trips to specific drive

Optimizer Live Re-Optimisation coming soon

A planned extension that lets the optimiser react to in-flight events — cancellations, no-shows, delays — by replanning

Optimizer Merge Pools

Groups eligible trips into evaluation pools before they're optimised, so the engine only ever compares genuinely combina

Optimizer Merge Strategies

Hierarchical merge-preference resolution: each actor (Customer, Account, AccountDepartment, Trip) can declare a MergePre

Optimizer Segment Redistribution coming soon

A planned extension that reshuffles work at the segment level: instead of merging whole trips, it can take segments from

Proof of Delivery coming soon

Captures proof of completion — signature, photo, delivery code, plus who/when — against the Package at the delivery stop

Real-World Routing

Real-world routing for any two points — driving distance, duration and turn-by-turn geometry

Recurring Trips

A TripSchedule links a master Trip to a recurrence pattern (TripSchedulePlan) so the platform clones the trip on every m

Release Decision History

Append-only record of every release-timing decision for a trip — the initial CREATE/UPDATE from the learned release-time

Schedule Exclusions

Operator-managed groups that pause one or many recurring trips for known disruptions — bad weather, voting days, school

SCP Safety Envelope coming soon

Extra safety monitoring for a special-category passenger once they are on board — tighter alerts for a driver going GPS-

Driver-initiated counterpart to automatic zone entry: a driver declares the zone they are driving to and reserves a queu

Per-stop time windows constrain when a pickup or dropoff may happen — a customer's "between 9 and 10am at the school", a

Traffic Heatmap

Heatmap endpoint returning per-H3-cell outbound traffic congestion factors at a given day-type + time-slot

Trip Capacity Constraints

Guarantees a shared ride never exceeds the vehicle's capacity

Trip Edit Mode (Soft Lock)

Time-bound soft indicator that an operator is currently editing a trip

Trip Guards System

Architectural overview of the lifecycle-guard subsystem: pre-flight checks that block or surface advice on a trip transi

Trip Health Dashboard

HTTP API powering the operator console health dashboard: traffic-light summary of WARNING / CRITICAL counts across all a

Trip Health Monitoring

Continuous monitoring of every active trip for risk conditions — late prediction, stale GPS, allocation risk, tight wind

Trip Health System

Architectural overview of the trip-health subsystem: how checks are evaluated each sweep, the WARNING / CRITICAL severit

Trip Lateness Attribution

Reusable, at-any-stage answer to "is this trip running late, and by how much" plus a SYSTEM/DRIVER/CUSTOMER fault decomp

Trip Lifecycle System

An end-to-end view of how a trip moves through its states — from booking through allocation, dispatch and in-progress to

The continuous optimisation sweep

Trip Optimizer System

An overview of how the platform combines and sequences trips for efficiency: the merge-strategy hierarchy that decides w

Trip Payment Operations

HTTP endpoints to manually trigger booking-time preauth, trip-end capture, or refund on a specific segment

Trip Planning System

How a booking becomes the concrete work a driver carries out — resolving it into executable units, deciding how segments

A unit of work is one self-contained run of driver work — typically an uninterrupted sequence of stops

Operator-defined categories that classify trips based on a JSON decision tree (e.g

Trip Rejections

Records every booking that was rejected before becoming a Trip — explicit operator decline, no-supply (no driver availab

Trip Scheduling & Timings

How the platform reasons about time across a trip — the derived timing metrics (such as acceptable arrival and dispatch

A TripSegment is one leg of a Trip — the work between two stops with its own pickup, dropoff, capacity requirements, lif

A TripSegmentStop is one waypoint on a segment — pickup, dropoff, or intermediate stop

A comprehensive read-only view of a single trip — timeline, driver/vehicle, account + custom fields, per-segment stops w

A Trip is the top-level booking record on the platform

Zone Entry Queueing

Automatically places drivers into the zones whose areas they enter