Quickstart

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",
        "capacity": { "weight": 100 },
        "shifts": [
          {
            "from": "2026-04-01T08:00:00+02:00",
            "to":   "2026-04-01T17:00:00+02:00",
            "start": { "coordinate": [4.3517, 50.8503] },
            "end":   { "coordinate": [4.3517, 50.8503] }
          }
        ]
      }
    ],
    "jobs": [
      {
        "id": "delivery-1",
        "location": { "coordinate": [4.7005, 50.8798] },
        "service_duration_s": 300,
        "time_windows": [
          {
            "from": "2026-04-01T09:00:00+02:00",
            "to":   "2026-04-01T12:00:00+02:00"
          }
        ],
        "demand": { "weight": 10 }
      },
      {
        "id": "delivery-2",
        "location": { "coordinate": [3.7303, 51.0500] },
        "service_duration_s": 600,
        "time_windows": [
          {
            "from": "2026-04-01T10:00:00+02:00",
            "to":   "2026-04-01T15:00:00+02:00"
          }
        ],
        "demand": { "weight": 20 }
      }
    ]
  }'

{
  "summary": {
    "status": "solved",
    "vehicles_used": 1,
    "jobs_assigned": 2,
    "jobs_unassigned": 0,
    "total_distance_m": 142000,
    "total_duration_s": 7200,
    "estimated_cost": {
      "total": 7200,
      "components": {
        "travel": 7200,
        "waiting": 0,
        "overtime": 0,
        "lateness": 0,
        "vehicles_fixed": 0,
        "unassigned": 0,
        "preferences": 0,
        "imbalance": 0
      }
    },
    "elapsed_ms": 850,
    "iterations": 1200
  },
  "routes": [
    {
      "vehicle": { "type": "truck-1", "instance": 1 },
      "distance_m": 142000,
      "duration_s": 7200,
      "overtime_s": 0,
      "stops": [
        {
          "type": "start",
          "location": [4.3517, 50.8503],
          "departure": "2026-04-01T08:00:00+02:00"
        },
        {
          "type": "job",
          "id": "delivery-2",
          "location": [3.7303, 51.0500],
          "arrival": "2026-04-01T10:00:00+02:00",
          "departure": "2026-04-01T10:10:00+02:00",
          "wait_s": 0,
          "service_s": 600,
          "travel_time_s": 7200,
          "load_after": { "weight": 20 }
        },
        {
          "type": "job",
          "id": "delivery-1",
          "location": [4.7005, 50.8798],
          "arrival": "2026-04-01T11:10:00+02:00",
          "departure": "2026-04-01T11:15:00+02:00",
          "wait_s": 0,
          "service_s": 300,
          "travel_time_s": 3600,
          "load_after": { "weight": 30 }
        },
        {
          "type": "end",
          "location": [4.3517, 50.8503],
          "arrival": "2026-04-01T12:15:00+02:00"
        }
      ]
    }
  ],
  "unassigned": []
}