Endpoints
Solve
Submit a vehicle routing problem and receive optimized routes
POST
/
v3
/
routing
/
solve
Solve a vehicle routing problem
curl --request POST \
--url https://api.solvice.io/v3/routing/solve \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"options": {
"seed": 42,
"time_limit_s": 5
},
"problem": {
"depots": [
{
"id": "gent",
"location": [
3.7174,
51.0543
]
}
],
"jobs": [
{
"id": "job-1",
"location": [
3.725,
51.05
],
"pickup_load": {
"weight": 20
},
"required_skills": [
{
"name": "fridge"
}
],
"service_duration_s": 300,
"time_windows": [
{
"from": "2026-07-01T09:00:00+02:00",
"to": "2026-07-01T12:00:00+02:00"
}
]
},
{
"id": "job-2",
"location": [
3.71,
51.06
],
"pickup_load": {
"weight": 35
},
"service_duration_s": 600
}
],
"objective": {
"costs": {
"per_route_hour": 35,
"per_travel_km": 0.2
},
"currency": "EUR"
},
"vehicles": [
{
"capacity": {
"weight": 500
},
"id": "v1",
"profile": "car",
"shifts": [
{
"end": {
"depot": "gent"
},
"from": "2026-07-01T08:00:00+02:00",
"id": "mon",
"start": {
"depot": "gent"
},
"to": "2026-07-01T17:00:00+02:00"
}
],
"skills": [
{
"name": "fridge"
}
]
}
]
}
}
'import requests
url = "https://api.solvice.io/v3/routing/solve"
payload = {
"options": {
"seed": 42,
"time_limit_s": 5
},
"problem": {
"depots": [
{
"id": "gent",
"location": [3.7174, 51.0543]
}
],
"jobs": [
{
"id": "job-1",
"location": [3.725, 51.05],
"pickup_load": { "weight": 20 },
"required_skills": [{ "name": "fridge" }],
"service_duration_s": 300,
"time_windows": [
{
"from": "2026-07-01T09:00:00+02:00",
"to": "2026-07-01T12:00:00+02:00"
}
]
},
{
"id": "job-2",
"location": [3.71, 51.06],
"pickup_load": { "weight": 35 },
"service_duration_s": 600
}
],
"objective": {
"costs": {
"per_route_hour": 35,
"per_travel_km": 0.2
},
"currency": "EUR"
},
"vehicles": [
{
"capacity": { "weight": 500 },
"id": "v1",
"profile": "car",
"shifts": [
{
"end": { "depot": "gent" },
"from": "2026-07-01T08:00:00+02:00",
"id": "mon",
"start": { "depot": "gent" },
"to": "2026-07-01T17:00:00+02:00"
}
],
"skills": [{ "name": "fridge" }]
}
]
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
options: {seed: 42, time_limit_s: 5},
problem: {
depots: [{id: 'gent', location: [3.7174, 51.0543]}],
jobs: [
{
id: 'job-1',
location: [3.725, 51.05],
pickup_load: {weight: 20},
required_skills: [{name: 'fridge'}],
service_duration_s: 300,
time_windows: [{from: '2026-07-01T09:00:00+02:00', to: '2026-07-01T12:00:00+02:00'}]
},
{
id: 'job-2',
location: [3.71, 51.06],
pickup_load: {weight: 35},
service_duration_s: 600
}
],
objective: {costs: {per_route_hour: 35, per_travel_km: 0.2}, currency: 'EUR'},
vehicles: [
{
capacity: {weight: 500},
id: 'v1',
profile: 'car',
shifts: [
{
end: {depot: 'gent'},
from: '2026-07-01T08:00:00+02:00',
id: 'mon',
start: {depot: 'gent'},
to: '2026-07-01T17:00:00+02:00'
}
],
skills: [{name: 'fridge'}]
}
]
}
})
};
fetch('https://api.solvice.io/v3/routing/solve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.solvice.io/v3/routing/solve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'options' => [
'seed' => 42,
'time_limit_s' => 5
],
'problem' => [
'depots' => [
[
'id' => 'gent',
'location' => [
3.7174,
51.0543
]
]
],
'jobs' => [
[
'id' => 'job-1',
'location' => [
3.725,
51.05
],
'pickup_load' => [
'weight' => 20
],
'required_skills' => [
[
'name' => 'fridge'
]
],
'service_duration_s' => 300,
'time_windows' => [
[
'from' => '2026-07-01T09:00:00+02:00',
'to' => '2026-07-01T12:00:00+02:00'
]
]
],
[
'id' => 'job-2',
'location' => [
3.71,
51.06
],
'pickup_load' => [
'weight' => 35
],
'service_duration_s' => 600
]
],
'objective' => [
'costs' => [
'per_route_hour' => 35,
'per_travel_km' => 0.2
],
'currency' => 'EUR'
],
'vehicles' => [
[
'capacity' => [
'weight' => 500
],
'id' => 'v1',
'profile' => 'car',
'shifts' => [
[
'end' => [
'depot' => 'gent'
],
'from' => '2026-07-01T08:00:00+02:00',
'id' => 'mon',
'start' => [
'depot' => 'gent'
],
'to' => '2026-07-01T17:00:00+02:00'
]
],
'skills' => [
[
'name' => 'fridge'
]
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.solvice.io/v3/routing/solve"
payload := strings.NewReader("{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.solvice.io/v3/routing/solve")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.solvice.io/v3/routing/solve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"plan": {
"routes": [
{
"shift": "mon",
"stops": [
{
"id": "job-1",
"type": "job"
},
{
"id": "job-2",
"type": "job"
}
],
"vehicle": "v1"
}
]
},
"routes": [
{
"distance_m": 8450,
"load_peak": {
"weight": 55
},
"shift": "mon",
"stops": [
{
"arrival": "2026-07-01T08:00:00+02:00",
"departure": "2026-07-01T08:00:00+02:00",
"depot": "gent",
"load_after": {
"weight": 0
},
"location": [
3.7174,
51.0543
],
"service_s": 0,
"type": "start"
},
{
"arrival": "2026-07-01T08:10:00+02:00",
"departure": "2026-07-01T09:05:00+02:00",
"distance_m": 2600,
"id": "job-1",
"lateness_s": 0,
"load_after": {
"weight": 20
},
"location": [
3.725,
51.05
],
"service_s": 300,
"service_start": "2026-07-01T09:00:00+02:00",
"travel_s": 600,
"type": "job",
"wait_s": 3000
},
{
"arrival": "2026-07-01T09:13:00+02:00",
"departure": "2026-07-01T09:23:00+02:00",
"distance_m": 2350,
"id": "job-2",
"lateness_s": 0,
"load_after": {
"weight": 55
},
"location": [
3.71,
51.06
],
"service_s": 600,
"service_start": "2026-07-01T09:13:00+02:00",
"travel_s": 480,
"type": "job",
"wait_s": 0
},
{
"arrival": "2026-07-01T09:38:00+02:00",
"departure": "2026-07-01T09:38:00+02:00",
"depot": "gent",
"distance_m": 3500,
"load_after": {
"weight": 55
},
"location": [
3.7174,
51.0543
],
"service_s": 0,
"travel_s": 900,
"type": "end",
"wait_s": 0
}
],
"time": {
"break_s": 0,
"depot_s": 0,
"overtime_s": 0,
"service_s": 900,
"span_s": 5880,
"travel_s": 1980,
"wait_s": 3000
},
"vehicle": "v1"
}
],
"summary": {
"distance_m": 8450,
"score": {
"components": {
"assignment": 0,
"delay": 0,
"distance": 1.69,
"drop_costs": 0,
"grouping": 0,
"lateness": 0,
"overtime": 0,
"preferences": 0,
"reloads": 0,
"routes": 0,
"tag_preference": 0,
"target": 0,
"time": 57.1536,
"vehicles": 0,
"waiting": 0,
"window_choice": 0,
"workload_share": 0
},
"cost": 58.8436,
"currency": "EUR",
"unassigned_priority": 0,
"violation_count": 0
},
"search": {
"iterations": 48210,
"termination": "time_limit"
},
"shifts_used": 1,
"tasks": {
"served": 2,
"unassigned": 0,
"unassigned_required": 0
},
"time": {
"break_s": 0,
"depot_s": 0,
"overtime_s": 0,
"service_s": 900,
"span_s": 5880,
"travel_s": 1980,
"wait_s": 3000
},
"timings": {
"search_ms": 100,
"total_ms": 142
},
"vehicles_used": 1
},
"unassigned": [],
"warnings": []
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "feature_not_enabled",
"message": "travel.engine: 'tomtom_real_time' is not enabled for this account; use engine 'tomtom'",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "FORBIDDEN"
}{
"code": "payload_too_large",
"message": "Request body exceeds 10485760 bytes",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "PAYLOAD_TOO_LARGE"
}{
"code": "unsupported_media_type",
"message": "Expected request with `Content-Type: application/json`",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "UNSUPPORTED_MEDIA_TYPE"
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "overloaded",
"message": "All solver slots are busy, try again later",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "SERVICE_UNAVAILABLE"
}V3 is in beta. General availability (GA) is planned for January 2027.
Authorizations
Body
application/json
Request body for POST /v3/routing/solve.
The problem: tasks, fleet, depots, relations, objective, travel.
Show child attributes
Show child attributes
Example:
{
"depots": [
{
"id": "gent",
"location": [3.7174, 51.0543]
}
],
"jobs": [
{
"id": "job-1",
"location": [3.725, 51.05],
"pickup_load": { "weight": 20 },
"service_duration_s": 300
}
],
"vehicles": [
{
"capacity": { "weight": 500 },
"id": "v1",
"shifts": [
{
"end": { "depot": "gent" },
"from": "2026-07-01T08:00:00+02:00",
"id": "mon",
"start": { "depot": "gent" },
"to": "2026-07-01T17:00:00+02:00"
}
]
}
]
}
Solve options.
Show child attributes
Show child attributes
Example:
{
"polyline": "full",
"seed": 42,
"time_limit_s": 5
}
Warm start: the plan the search starts from instead of constructing
from scratch (re-optimization). A result's plan goes in as it stands.
See plan.routes[].locked_count for freezing a dispatched prefix.
A hint, not a guarantee: an unlocked stop that violates a hard
constraint (e.g. capacity, skills, eligibility, limits.*, or a time
window with no per_late_hour set) is left unassigned and the
search reinserts it wherever it legitimately fits, or it surfaces in
unassigned[] with a typed reason. On synchronous solve and stream, an
infeasible locked or pinned stop is a 400. POST /v3/routing/runs checks
the problem at submission, not the plan, so there the run ends failed
with BAD_REQUEST instead.
Show child attributes
Show child attributes
Response
Solution found.
The result of POST /v3/routing/solve and POST /v3/routing/evaluate:
one shape for a plan the solver built and a plan it was given to score.
The plan these routes follow, in the request's vocabulary: valid input to evaluate, suggest or a warm-started solve as it stands.
Show child attributes
Show child attributes
One entry per non-empty route.
Show child attributes
Show child attributes
Aggregate statistics for the solve run.
Show child attributes
Show child attributes
Example:
{
"distance_m": 8450,
"score": {
"components": {
"assignment": 0,
"delay": 0,
"distance": 1.69,
"drop_costs": 0,
"grouping": 0,
"lateness": 0,
"overtime": 0,
"preferences": 0,
"reloads": 0,
"routes": 0,
"tag_preference": 0,
"target": 0,
"time": 57.1536,
"vehicles": 0,
"waiting": 0,
"window_choice": 0,
"workload_share": 0
},
"cost": 58.8436,
"currency": "EUR",
"unassigned_priority": 0,
"violation_count": 0
},
"search": {
"iterations": 48210,
"termination": "time_limit"
},
"shifts_used": 1,
"tasks": {
"served": 2,
"unassigned": 0,
"unassigned_required": 0
},
"time": {
"break_s": 0,
"depot_s": 0,
"overtime_s": 0,
"service_s": 900,
"span_s": 5880,
"travel_s": 1980,
"wait_s": 3000
},
"timings": { "search_ms": 100, "total_ms": 142 },
"vehicles_used": 1
}
Tasks that could not be feasibly assigned.
Show child attributes
Show child attributes
Inputs the request carried that changed nothing. Always present,
empty when there are none (no input produces one today); at most 100
are returned. Each item has a code, a pointer to the field and a
message. Accept codes you do not know.
Show child attributes
Show child attributes
How the best plan improved during the search, oldest first: the
starting plan, every improvement (thinned to at most 500 entries), and
the final plan, which equals summary.score (it can equal, or be
slightly worse than, the entry before it). Present on every solve;
absent on evaluate, which does not search. A large request that is
solved in parts has the final entry alone.
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Solve a vehicle routing problem
curl --request POST \
--url https://api.solvice.io/v3/routing/solve \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"options": {
"seed": 42,
"time_limit_s": 5
},
"problem": {
"depots": [
{
"id": "gent",
"location": [
3.7174,
51.0543
]
}
],
"jobs": [
{
"id": "job-1",
"location": [
3.725,
51.05
],
"pickup_load": {
"weight": 20
},
"required_skills": [
{
"name": "fridge"
}
],
"service_duration_s": 300,
"time_windows": [
{
"from": "2026-07-01T09:00:00+02:00",
"to": "2026-07-01T12:00:00+02:00"
}
]
},
{
"id": "job-2",
"location": [
3.71,
51.06
],
"pickup_load": {
"weight": 35
},
"service_duration_s": 600
}
],
"objective": {
"costs": {
"per_route_hour": 35,
"per_travel_km": 0.2
},
"currency": "EUR"
},
"vehicles": [
{
"capacity": {
"weight": 500
},
"id": "v1",
"profile": "car",
"shifts": [
{
"end": {
"depot": "gent"
},
"from": "2026-07-01T08:00:00+02:00",
"id": "mon",
"start": {
"depot": "gent"
},
"to": "2026-07-01T17:00:00+02:00"
}
],
"skills": [
{
"name": "fridge"
}
]
}
]
}
}
'import requests
url = "https://api.solvice.io/v3/routing/solve"
payload = {
"options": {
"seed": 42,
"time_limit_s": 5
},
"problem": {
"depots": [
{
"id": "gent",
"location": [3.7174, 51.0543]
}
],
"jobs": [
{
"id": "job-1",
"location": [3.725, 51.05],
"pickup_load": { "weight": 20 },
"required_skills": [{ "name": "fridge" }],
"service_duration_s": 300,
"time_windows": [
{
"from": "2026-07-01T09:00:00+02:00",
"to": "2026-07-01T12:00:00+02:00"
}
]
},
{
"id": "job-2",
"location": [3.71, 51.06],
"pickup_load": { "weight": 35 },
"service_duration_s": 600
}
],
"objective": {
"costs": {
"per_route_hour": 35,
"per_travel_km": 0.2
},
"currency": "EUR"
},
"vehicles": [
{
"capacity": { "weight": 500 },
"id": "v1",
"profile": "car",
"shifts": [
{
"end": { "depot": "gent" },
"from": "2026-07-01T08:00:00+02:00",
"id": "mon",
"start": { "depot": "gent" },
"to": "2026-07-01T17:00:00+02:00"
}
],
"skills": [{ "name": "fridge" }]
}
]
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
options: {seed: 42, time_limit_s: 5},
problem: {
depots: [{id: 'gent', location: [3.7174, 51.0543]}],
jobs: [
{
id: 'job-1',
location: [3.725, 51.05],
pickup_load: {weight: 20},
required_skills: [{name: 'fridge'}],
service_duration_s: 300,
time_windows: [{from: '2026-07-01T09:00:00+02:00', to: '2026-07-01T12:00:00+02:00'}]
},
{
id: 'job-2',
location: [3.71, 51.06],
pickup_load: {weight: 35},
service_duration_s: 600
}
],
objective: {costs: {per_route_hour: 35, per_travel_km: 0.2}, currency: 'EUR'},
vehicles: [
{
capacity: {weight: 500},
id: 'v1',
profile: 'car',
shifts: [
{
end: {depot: 'gent'},
from: '2026-07-01T08:00:00+02:00',
id: 'mon',
start: {depot: 'gent'},
to: '2026-07-01T17:00:00+02:00'
}
],
skills: [{name: 'fridge'}]
}
]
}
})
};
fetch('https://api.solvice.io/v3/routing/solve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.solvice.io/v3/routing/solve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'options' => [
'seed' => 42,
'time_limit_s' => 5
],
'problem' => [
'depots' => [
[
'id' => 'gent',
'location' => [
3.7174,
51.0543
]
]
],
'jobs' => [
[
'id' => 'job-1',
'location' => [
3.725,
51.05
],
'pickup_load' => [
'weight' => 20
],
'required_skills' => [
[
'name' => 'fridge'
]
],
'service_duration_s' => 300,
'time_windows' => [
[
'from' => '2026-07-01T09:00:00+02:00',
'to' => '2026-07-01T12:00:00+02:00'
]
]
],
[
'id' => 'job-2',
'location' => [
3.71,
51.06
],
'pickup_load' => [
'weight' => 35
],
'service_duration_s' => 600
]
],
'objective' => [
'costs' => [
'per_route_hour' => 35,
'per_travel_km' => 0.2
],
'currency' => 'EUR'
],
'vehicles' => [
[
'capacity' => [
'weight' => 500
],
'id' => 'v1',
'profile' => 'car',
'shifts' => [
[
'end' => [
'depot' => 'gent'
],
'from' => '2026-07-01T08:00:00+02:00',
'id' => 'mon',
'start' => [
'depot' => 'gent'
],
'to' => '2026-07-01T17:00:00+02:00'
]
],
'skills' => [
[
'name' => 'fridge'
]
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.solvice.io/v3/routing/solve"
payload := strings.NewReader("{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.solvice.io/v3/routing/solve")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.solvice.io/v3/routing/solve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"options\": {\n \"seed\": 42,\n \"time_limit_s\": 5\n },\n \"problem\": {\n \"depots\": [\n {\n \"id\": \"gent\",\n \"location\": [\n 3.7174,\n 51.0543\n ]\n }\n ],\n \"jobs\": [\n {\n \"id\": \"job-1\",\n \"location\": [\n 3.725,\n 51.05\n ],\n \"pickup_load\": {\n \"weight\": 20\n },\n \"required_skills\": [\n {\n \"name\": \"fridge\"\n }\n ],\n \"service_duration_s\": 300,\n \"time_windows\": [\n {\n \"from\": \"2026-07-01T09:00:00+02:00\",\n \"to\": \"2026-07-01T12:00:00+02:00\"\n }\n ]\n },\n {\n \"id\": \"job-2\",\n \"location\": [\n 3.71,\n 51.06\n ],\n \"pickup_load\": {\n \"weight\": 35\n },\n \"service_duration_s\": 600\n }\n ],\n \"objective\": {\n \"costs\": {\n \"per_route_hour\": 35,\n \"per_travel_km\": 0.2\n },\n \"currency\": \"EUR\"\n },\n \"vehicles\": [\n {\n \"capacity\": {\n \"weight\": 500\n },\n \"id\": \"v1\",\n \"profile\": \"car\",\n \"shifts\": [\n {\n \"end\": {\n \"depot\": \"gent\"\n },\n \"from\": \"2026-07-01T08:00:00+02:00\",\n \"id\": \"mon\",\n \"start\": {\n \"depot\": \"gent\"\n },\n \"to\": \"2026-07-01T17:00:00+02:00\"\n }\n ],\n \"skills\": [\n {\n \"name\": \"fridge\"\n }\n ]\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"plan": {
"routes": [
{
"shift": "mon",
"stops": [
{
"id": "job-1",
"type": "job"
},
{
"id": "job-2",
"type": "job"
}
],
"vehicle": "v1"
}
]
},
"routes": [
{
"distance_m": 8450,
"load_peak": {
"weight": 55
},
"shift": "mon",
"stops": [
{
"arrival": "2026-07-01T08:00:00+02:00",
"departure": "2026-07-01T08:00:00+02:00",
"depot": "gent",
"load_after": {
"weight": 0
},
"location": [
3.7174,
51.0543
],
"service_s": 0,
"type": "start"
},
{
"arrival": "2026-07-01T08:10:00+02:00",
"departure": "2026-07-01T09:05:00+02:00",
"distance_m": 2600,
"id": "job-1",
"lateness_s": 0,
"load_after": {
"weight": 20
},
"location": [
3.725,
51.05
],
"service_s": 300,
"service_start": "2026-07-01T09:00:00+02:00",
"travel_s": 600,
"type": "job",
"wait_s": 3000
},
{
"arrival": "2026-07-01T09:13:00+02:00",
"departure": "2026-07-01T09:23:00+02:00",
"distance_m": 2350,
"id": "job-2",
"lateness_s": 0,
"load_after": {
"weight": 55
},
"location": [
3.71,
51.06
],
"service_s": 600,
"service_start": "2026-07-01T09:13:00+02:00",
"travel_s": 480,
"type": "job",
"wait_s": 0
},
{
"arrival": "2026-07-01T09:38:00+02:00",
"departure": "2026-07-01T09:38:00+02:00",
"depot": "gent",
"distance_m": 3500,
"load_after": {
"weight": 55
},
"location": [
3.7174,
51.0543
],
"service_s": 0,
"travel_s": 900,
"type": "end",
"wait_s": 0
}
],
"time": {
"break_s": 0,
"depot_s": 0,
"overtime_s": 0,
"service_s": 900,
"span_s": 5880,
"travel_s": 1980,
"wait_s": 3000
},
"vehicle": "v1"
}
],
"summary": {
"distance_m": 8450,
"score": {
"components": {
"assignment": 0,
"delay": 0,
"distance": 1.69,
"drop_costs": 0,
"grouping": 0,
"lateness": 0,
"overtime": 0,
"preferences": 0,
"reloads": 0,
"routes": 0,
"tag_preference": 0,
"target": 0,
"time": 57.1536,
"vehicles": 0,
"waiting": 0,
"window_choice": 0,
"workload_share": 0
},
"cost": 58.8436,
"currency": "EUR",
"unassigned_priority": 0,
"violation_count": 0
},
"search": {
"iterations": 48210,
"termination": "time_limit"
},
"shifts_used": 1,
"tasks": {
"served": 2,
"unassigned": 0,
"unassigned_required": 0
},
"time": {
"break_s": 0,
"depot_s": 0,
"overtime_s": 0,
"service_s": 900,
"span_s": 5880,
"travel_s": 1980,
"wait_s": 3000
},
"timings": {
"search_ms": 100,
"total_ms": 142
},
"vehicles_used": 1
},
"unassigned": [],
"warnings": []
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "feature_not_enabled",
"message": "travel.engine: 'tomtom_real_time' is not enabled for this account; use engine 'tomtom'",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "FORBIDDEN"
}{
"code": "payload_too_large",
"message": "Request body exceeds 10485760 bytes",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "PAYLOAD_TOO_LARGE"
}{
"code": "unsupported_media_type",
"message": "Expected request with `Content-Type: application/json`",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "UNSUPPORTED_MEDIA_TYPE"
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "invalid_request",
"errors": [
{
"code": "out_of_range",
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"pointer": "/problem/depots/0/service_duration_s"
}
],
"message": "depot 'gent': service_duration_s must be >= 0, got -60",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "BAD_REQUEST"
}{
"code": "overloaded",
"message": "All solver slots are busy, try again later",
"request_id": "req_7f3a2c90d1e4b5a6",
"status": "SERVICE_UNAVAILABLE"
}