Skip to main content
POST
Solve a vehicle routing problem

Authorizations

Authorization
string
header
required

Body

application/json

Top-level request body for POST /v3/routing/solve (schema v2).

jobs
object[]
required

Jobs to serve (replaces jobs[] + shipments[]).

vehicles
object[]
required

Available vehicles.

depots
object[] | null

Named depots.

locations
object[] | null

Optional shared location table; tasks/depots/shifts may reference by id.

objective
null | object

Objective configuration.

options
null | object

Solver runtime / output / async options.

relations
object[] | null

Ordering, grouping, and synchronization constraints.

A constraint between tasks. Tagged union; each variant carries only its valid fields. Each relation references either explicit job_ids or a group (tag) — validated not-both. violation_cost absent = hard.

Response

Solution found

Top-level response body for POST /v3/routing/solve (schema v2).

routes
object[]
required

One entry per non-empty route.

summary
object
required

Aggregate statistics for the solve run.

unassigned
object[]
required

Tasks that could not be feasibly assigned.