Capabilities and pricing
One code is the billing unit, the authorization scope, the MCP tool scope and the documentation anchor.
Everything is listed here, including capabilities your account has not enabled — you have to be able to tell "not subscribed" from "does not exist". Capability codes are permanent: they are never renamed, never reused, and never re-scoped. Changing what a capability bills requires a new code.
Route optimization
| Capability | Description | Billed in | Stage |
|---|---|---|---|
routing.optimize
|
Route optimization Plan routes across a fleet from jobs, vehicles and constraints you supply. |
node | Stable |
routing.refine
|
Route refinement Re-optimize an existing plan locally or globally, keeping chosen stops frozen. |
node | Stable |
routing.whatif
|
Plan comparison Score several alternative plans side by side without committing to any. |
call | Beta |
routing.insert
|
Stop insertion (beta) Place new jobs in a plan you hold at the positions that cost least, without resequencing the rest. |
node | Beta |
Dispatch
| Capability | Description | Billed in | Stage |
|---|---|---|---|
plan.recost
|
Plan re-costing Price an edited plan exactly as given — per-leg distance, duration and road geometry, with arrival times — without resequencing it. Stated constraints (time windows, capacity, skills, vehicle ceilings) are judged and reported as violations, never refused. |
node | Stable |
plan.validate
|
Plan validation Judge a plan against its stated constraints — time windows, capacity, skills, vehicle ceilings — with every violation named. The same evaluator as re-costing, without the map payload. |
node | Stable |
plan.resequence
|
Route reordering (beta) Give one route of a plan you hold a new stop order and receive the edited plan priced, with every violation named. |
node | Beta |
plan.move
|
Stop moves (beta) Move stops of a plan you hold to a route at a chosen position and receive the edited plan priced, with whether the routes it touched keep their rules. |
node | Beta |
plan.remove
|
Stop removal (beta) Take stops of a plan you hold off their routes into the unassigned pool and receive the edited plan priced. |
node | Beta |
plan.insert
|
Job insertion (beta) Place new jobs in a plan you hold at their cheapest positions, without re-planning the rest, and receive the plan priced with the positions to choose from. |
node | Beta |
plan.refine
|
Route refinement (beta) Re-order the stops of chosen routes of a plan you hold around stops you lock, and receive the plan priced; a new order is kept only when it is better. |
node | Beta |
plan.what_if
|
Plan comparison (beta) Price and judge several alternative plans of the same vehicles and jobs and receive them ranked. |
node | Beta |
Delivery slots
| Capability | Description | Billed in | Stage |
|---|---|---|---|
slots.quote
|
Slot quotes (beta) For one new job, find which delivery slots a plan you hold can take and what each costs. |
node | Beta |
Geocoding
| Capability | Description | Billed in | Stage |
|---|---|---|---|
geo.forward
|
Forward geocoding Turn an address into coordinates through a per-country provider chain. |
point | Stable |
geo.reverse
|
Reverse geocoding Turn coordinates into a structured address. |
point | Stable |
geo.batch
|
Batch geocoding Geocode many addresses in one call, billed per thousand points. |
point_1k | Stable |
geo.validate
|
Address validation Normalize an address and check its postcode, PO Box status and phone number. |
point | Stable |
geo.autocomplete
|
Address autocomplete (beta) Suggest addresses while they are typed, then give the chosen one as a structured address with coordinates. |
call | Beta |
Distance matrix
| Capability | Description | Billed in | Stage |
|---|---|---|---|
matrix.compute
|
Distance matrix (beta) Distances and durations between many origins and destinations. |
element_1k | Beta |
Directions
| Capability | Description | Billed in | Stage |
|---|---|---|---|
directions.compute
|
Directions Road geometry, distance and duration between waypoints. |
call | Stable |
Reach areas
| Capability | Description | Billed in | Stage |
|---|---|---|---|
isochrone.compute
|
Reach areas (beta) Draw the areas reachable from a point within given drive times. |
call | Beta |
Map matching
| Capability | Description | Billed in | Stage |
|---|---|---|---|
trace.match
|
Map matching (beta) Snap a GPS trace to the roads it was driven on and measure the drive. |
point_1k | Beta |
Chargeable weight
| Capability | Description | Billed in | Stage |
|---|---|---|---|
weight.chargeable
|
Chargeable weight (beta) Work out the weight a carrier bills: the greater of actual and volumetric weight. |
call | Beta |
Barcodes
| Capability | Description | Billed in | Stage |
|---|---|---|---|
label.barcode
|
Barcodes (beta) Draw a barcode or a QR, Data Matrix or PDF417 code as an image. |
call | Beta |
Document checks
| Capability | Description | Billed in | Stage |
|---|---|---|---|
document.verify
|
Document checks (beta) Check whether a PDF was issued by Superroute and is unchanged since. |
call | Beta |
Arrival estimates
| Capability | Description | Billed in | Stage |
|---|---|---|---|
eta.estimate
|
Arrival estimates Recompute arrival times along a route from progress so far. |
call | Stable |
Maps
| Capability | Description | Billed in | Stage |
|---|---|---|---|
map.static
|
Static maps (beta) Draw your own lines, points and areas on the street map and receive a PNG image. |
call | Beta |
map.tiles
|
Map tiles (beta) Map keys and short-lived tokens for your own apps and pages; tiles are billed per thousand. |
tile_1k | Beta |
Carton selection
| Capability | Description | Billed in | Stage |
|---|---|---|---|
packing.solve
|
Carton selection (beta) Choose packaging and produce a 3D packing arrangement for a set of items. |
job | Beta |
Load planning
| Capability | Description | Billed in | Stage |
|---|---|---|---|
loading.solve
|
Load planning (beta) Place cargo in a trailer or container with centre of gravity and unload order. |
job | Beta |
Pick batching
| Capability | Description | Billed in | Stage |
|---|---|---|---|
picking.batch
|
Pick batching (beta) Group warehouse orders into pick batches and receive the walk through the bins for each batch. |
job | Beta |
Territory design
| Capability | Description | Billed in | Stage |
|---|---|---|---|
territory.design
|
Territory design (beta) Cut weighted points into compact, non-overlapping territories that each carry a balanced share of the work. |
point_1k | Beta |
Network scenarios
| Capability | Description | Billed in | Stage |
|---|---|---|---|
network.site_scenario
|
Network scenarios (beta) Compare your delivery days as they are with a new depot, a different fleet size or other shift hours. |
job | Beta |
Platform
| Capability | Description | Billed in | Stage |
|---|---|---|---|
platform.auth
|
Authentication Exchange an API token for a short-lived session token. |
free | Stable |
platform.capabilities
|
Capability discovery List what this key can call, at what price, against which quota. |
free | Stable |
platform.resources
|
Reusable resources Upload a fleet, depot or plan once and reference it by id. |
free | Stable |
platform.jobs
|
Async jobs Track a long-running solve and collect its result. |
free | Stable |
platform.health
|
Health Report platform liveness and engine reachability. |
free | Stable |
Billing units
The unit is part of the published contract. It appears on every billable response, so a charge can be reconciled from the response itself rather than taken on faith at the end of the month.
| Billed in | Description |
|---|---|
call |
One call, whatever its size. |
job |
One solve run, whatever the item count. |
point |
One address or coordinate. |
point_1k |
Thousands of points, charged fractionally. |
element_1k |
Thousands of matrix cells (origins x destinations), charged fractionally. |
tile_1k |
Thousands of map tiles, charged fractionally. |
node |
Every point the solver must visit or depart from, including each vehicle's start and end. |
free |
Never billed, and never disable-able. |