The Vehicle Routing Problem (VRP) API helps you optimize delivery routes, service appointments, and resource allocation. It finds the most efficient way to assign jobs to vehicles while respecting constraints like time windows, vehicle capacity, and driver skills.
The VRP solver handles complex real-world scenarios including multi-day planning, pickup & delivery, and route balancing.

​
Core Capabilities

Route Optimization

Find optimal sequences for deliveries and service calls

Resource Management

Assign the right vehicles and drivers to each job

Constraint Handling

Respect time windows, capacities, skills, and preferences

​
API Endpoints

The VRP API provides three types of operations:

​
Optimization Actions

POST /v2/vrp/solve
Finds the optimal solution for your routing problem. This is the main endpoint for route optimization.
Use this for daily route planning, delivery optimization, and service scheduling.

​
Result Retrieval

Once you’ve submitted a request, retrieve results using these endpoints:
​
job_id
string
required
The unique identifier returned when you submit a request
GET /v2/vrp/jobs/{job_id}/status

​
How It Works

1

Submit Request

Send your routing problem with resources (vehicles) and jobs (deliveries) to the solve endpoint.
{
  "resources": [...],
  "jobs": [...],
  "options": {...}
}
2

Monitor Progress

Check the job status while the solver optimizes your routes.
{
  "id": "job_123",
  "status": "SOLVING",
  "progress": 45
}
3

Retrieve Solution

Get the optimized routes once the solver completes.
{
  "trips": [...],
  "score": {...},
  "status": "SOLVED"
}

​
Key Features

  • Integration with OSM for actual road distances
  • Support for custom distance matrices
  • Fallback to haversine calculations
  • Time windows (hard and soft)
  • Vehicle capacity (volume, weight, count)
  • Driver skills and certifications
  • Preferred resources
  • Service dependencies
  • Plan routes across multiple days
  • Handle recurring appointments
  • Balance workload over planning periods
  • Add jobs to existing routes
  • Handle cancellations and changes
  • Real-time route adjustments

​
Common Use Cases

Last-Mile Delivery

Optimize delivery routes for e-commerce, food delivery, and courier services

Field Service

Schedule technicians for installations, repairs, and maintenance visits

Transportation

Plan pickup/delivery routes for passengers or goods

Healthcare

Route nurses and caregivers for home visits

​
Quick Start

Need an API key? Contact us to get started.
Ready to optimize your first route?

VRP Quickstart Guide

Solve your first routing problem in under 5 minutes

​
Additional Resources

API Reference

Detailed endpoint documentation

Examples

Real-world routing scenarios

Performance Guide

Tips for optimal results