Solve - Solvice Docs

POST

routing

solve

curl -X POST https://api.solvice.io/v3/routing/solve \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicles": [
      {
        "id": "truck-1",
        "start": [4.3517, 50.8503],
        "end": [4.3517, 50.8503],
        "shifts": [
          {
            "from": "2026-04-01T08:00:00+02:00",
            "to": "2026-04-01T17:00:00+02:00"
          }
        ],
        "capacity": [100],
        "skills": ["refrigerated"],
        "max_duration": 28800
      }
    ],
    "jobs": [
      {
        "id": "delivery-1",
        "location": [4.7005, 50.8798],
        "demand": [10],
        "time_windows": [
          {
            "from": "2026-04-01T09:00:00+02:00",
            "to": "2026-04-01T12:00:00+02:00"
          }
        ],
        "service_duration": 300,
        "skills": ["refrigerated"]
      },
      {
        "id": "delivery-2",
        "location": [3.7303, 51.05],
        "demand": [20],
        "time_windows": [
          {
            "from": "2026-04-01T10:00:00+02:00",
            "to": "2026-04-01T15:00:00+02:00"
          }
        ],
        "service_duration": 600
      }
    ],
    "options": {
      "time_limit_ms": 5000,
      "seed": 42,
      "minimize": "time"
    }
  }'

{
  "summary": {
    "status": "completed",
    "total_distance": 142000,
    "total_duration": 7200,
    "vehicles_used": 1,
    "jobs_assigned": 2,
    "jobs_unassigned": 0,
    "elapsed_ms": 850,
    "iterations": 1200
  },
  "routes": [
    {
      "vehicle_id": "truck-1",
      "shift_from": "2026-04-01T08:00:00+02:00",
      "shift_to": "2026-04-01T17:00:00+02:00",
      "stops": [
        {
          "job_id": "delivery-2",
          "location": [3.7303, 51.05],
          "arrival": "2026-04-01T08:40:00+02:00",
          "departure": "2026-04-01T08:50:00+02:00",
          "wait_time": 0,
          "travel_time": 2400,
          "service_time": 600,
          "load_after": [20]
        },
        {
          "job_id": "delivery-1",
          "location": [4.7005, 50.8798],
          "arrival": "2026-04-01T09:50:00+02:00",
          "departure": "2026-04-01T09:55:00+02:00",
          "wait_time": 0,
          "travel_time": 3600,
          "service_time": 300,
          "load_after": [30]
        }
      ],
      "distance": 142000,
      "duration": 7200,
      "load": 30,
      "n_stops": 2,
      "start_time": "2026-04-01T08:00:00+02:00",
      "end_time": "2026-04-01T10:30:00+02:00"
    }
  ],
  "unassigned": []
}

Request body

vehicles

array

required

List of available vehicles with start/end locations, capacity, and time windows.

Show Vehicle object

string

required

Unique vehicle identifier

start

array

required

Start location as [longitude, latitude]

end

array

End location as [longitude, latitude]. Defaults to start if omitted.

shifts

array

required

Working shifts. Each shift has from and to (ISO 8601), and can optionally override start, end, and capacity.

capacity

array

Capacity per dimension, e.g. [100] for weight or [50, 30] for weight + volume

skills

array

List of skill strings this vehicle provides

max_distance

integer

Maximum route distance in metres

max_duration

integer

Maximum route duration in seconds

jobs

array

required

List of jobs (deliveries, pickups, service visits) to assign to vehicles.

Show Job object

string

required

Unique job identifier

location

array

required

Location as [longitude, latitude]

demand

array

Capacity consumed per dimension, e.g. [10]

service_duration

integer

Service duration in seconds

time_windows

array

Allowed service windows, each with from and to (ISO 8601)

skills

array

Required vehicle skills

committed_vehicle

string

Lock this job to a specific vehicle ID

relations

array

Ordering constraints between jobs. Each relation has type ("SEQUENCE" or "FIRST_JOB") and jobs (ordered list of job IDs).

options

object

Solver options.

Show Options

time_limit_ms

integer

Wall-clock budget in milliseconds (default: 1000). Time spent fetching the distance matrix is deducted before solving.

seed

integer

Random seed for reproducible results (default: 42)

minimize

string

Primary objective: "time" (default) or "distance"

matrix

object

Custom pre-computed distance/duration matrix. When provided, no call to Solvice Maps is made. Must have distances and durations as square N×N arrays.

job_proximity_radius_m

integer

Radius in meters for classifying nearby jobs as proximity neighbors

job_proximity_weight

integer

Soft penalty per proximity violation (0–100,000)

Response

summary

object

Aggregate statistics for the solve run.

Show Summary

status

string

"completed" or "partial"

total_distance

integer

Sum of all route distances in metres

total_duration

integer

Sum of all route durations in seconds

vehicles_used

integer

Number of routes with at least one job

jobs_assigned

integer

Jobs placed in a route

jobs_unassigned

integer

Jobs that could not be assigned

elapsed_ms

integer

Wall-clock time of the entire request

iterations

integer

Solver iterations completed

routes

array

Optimized routes, one per used vehicle.

Show Route object

vehicle_id

string

Vehicle identifier

shift_from

string

Shift start (ISO 8601)

shift_to

string

Shift end (ISO 8601)

stops

array

Ordered list of job stops with job_id, location, arrival, departure, wait_time, travel_time, service_time, load_after

distance

integer

Total route distance in metres

duration

integer

Total route duration in seconds

load

integer

Total load consumed on this route

n_stops

integer

Number of job stops

start_time

string

Route departure time (ISO 8601)

end_time

string

Route return time (ISO 8601)

unassigned

array

Jobs that could not be assigned, each with job_id and reason

curl -X POST https://api.solvice.io/v3/routing/solve \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicles": [
      {
        "id": "truck-1",
        "start": [4.3517, 50.8503],
        "end": [4.3517, 50.8503],
        "shifts": [
          {
            "from": "2026-04-01T08:00:00+02:00",
            "to": "2026-04-01T17:00:00+02:00"
          }
        ],
        "capacity": [100],
        "skills": ["refrigerated"],
        "max_duration": 28800
      }
    ],
    "jobs": [
      {
        "id": "delivery-1",
        "location": [4.7005, 50.8798],
        "demand": [10],
        "time_windows": [
          {
            "from": "2026-04-01T09:00:00+02:00",
            "to": "2026-04-01T12:00:00+02:00"
          }
        ],
        "service_duration": 300,
        "skills": ["refrigerated"]
      },
      {
        "id": "delivery-2",
        "location": [3.7303, 51.05],
        "demand": [20],
        "time_windows": [
          {
            "from": "2026-04-01T10:00:00+02:00",
            "to": "2026-04-01T15:00:00+02:00"
          }
        ],
        "service_duration": 600
      }
    ],
    "options": {
      "time_limit_ms": 5000,
      "seed": 42,
      "minimize": "time"
    }
  }'

{
  "summary": {
    "status": "completed",
    "total_distance": 142000,
    "total_duration": 7200,
    "vehicles_used": 1,
    "jobs_assigned": 2,
    "jobs_unassigned": 0,
    "elapsed_ms": 850,
    "iterations": 1200
  },
  "routes": [
    {
      "vehicle_id": "truck-1",
      "shift_from": "2026-04-01T08:00:00+02:00",
      "shift_to": "2026-04-01T17:00:00+02:00",
      "stops": [
        {
          "job_id": "delivery-2",
          "location": [3.7303, 51.05],
          "arrival": "2026-04-01T08:40:00+02:00",
          "departure": "2026-04-01T08:50:00+02:00",
          "wait_time": 0,
          "travel_time": 2400,
          "service_time": 600,
          "load_after": [20]
        },
        {
          "job_id": "delivery-1",
          "location": [4.7005, 50.8798],
          "arrival": "2026-04-01T09:50:00+02:00",
          "departure": "2026-04-01T09:55:00+02:00",
          "wait_time": 0,
          "travel_time": 3600,
          "service_time": 300,
          "load_after": [30]
        }
      ],
      "distance": 142000,
      "duration": 7200,
      "load": 30,
      "n_stops": 2,
      "start_time": "2026-04-01T08:00:00+02:00",
      "end_time": "2026-04-01T10:30:00+02:00"
    }
  ],
  "unassigned": []
}

IntroductionV3 Routing API reference — vehicle routing optimization

⌘I

curl -X POST https://api.solvice.io/v3/routing/solve \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicles": [
      {
        "id": "truck-1",
        "start": [4.3517, 50.8503],
        "end": [4.3517, 50.8503],
        "shifts": [
          {
            "from": "2026-04-01T08:00:00+02:00",
            "to": "2026-04-01T17:00:00+02:00"
          }
        ],
        "capacity": [100],
        "skills": ["refrigerated"],
        "max_duration": 28800
      }
    ],
    "jobs": [
      {
        "id": "delivery-1",
        "location": [4.7005, 50.8798],
        "demand": [10],
        "time_windows": [
          {
            "from": "2026-04-01T09:00:00+02:00",
            "to": "2026-04-01T12:00:00+02:00"
          }
        ],
        "service_duration": 300,
        "skills": ["refrigerated"]
      },
      {
        "id": "delivery-2",
        "location": [3.7303, 51.05],
        "demand": [20],
        "time_windows": [
          {
            "from": "2026-04-01T10:00:00+02:00",
            "to": "2026-04-01T15:00:00+02:00"
          }
        ],
        "service_duration": 600
      }
    ],
    "options": {
      "time_limit_ms": 5000,
      "seed": 42,
      "minimize": "time"
    }
  }'

{
  "summary": {
    "status": "completed",
    "total_distance": 142000,
    "total_duration": 7200,
    "vehicles_used": 1,
    "jobs_assigned": 2,
    "jobs_unassigned": 0,
    "elapsed_ms": 850,
    "iterations": 1200
  },
  "routes": [
    {
      "vehicle_id": "truck-1",
      "shift_from": "2026-04-01T08:00:00+02:00",
      "shift_to": "2026-04-01T17:00:00+02:00",
      "stops": [
        {
          "job_id": "delivery-2",
          "location": [3.7303, 51.05],
          "arrival": "2026-04-01T08:40:00+02:00",
          "departure": "2026-04-01T08:50:00+02:00",
          "wait_time": 0,
          "travel_time": 2400,
          "service_time": 600,
          "load_after": [20]
        },
        {
          "job_id": "delivery-1",
          "location": [4.7005, 50.8798],
          "arrival": "2026-04-01T09:50:00+02:00",
          "departure": "2026-04-01T09:55:00+02:00",
          "wait_time": 0,
          "travel_time": 3600,
          "service_time": 300,
          "load_after": [30]
        }
      ],
      "distance": 142000,
      "duration": 7200,
      "load": 30,
      "n_stops": 2,
      "start_time": "2026-04-01T08:00:00+02:00",
      "end_time": "2026-04-01T10:30:00+02:00"
    }
  ],
  "unassigned": []
}

Routing API

​Request body

​Response

Request body

Response