RouteOpt
Developer Documentation

Build smarter logistics
with our APIs

RouteOpt provides a suite of APIs for route optimization, distance matrices, real-time re-optimization, ML predictions, and more. Integrate powerful logistics intelligence into any application.

Quick Start

5-minute interactive guide

API Reference

50+ endpoints documented

Try It Live

In-browser API playground

Quick Start

Your first optimization in 3 steps

1

Get your API key

Sign up for a free account, then generate an API key from the Settings page. Include it in every request.

2

Send a request

POST to /v1/optimize with your vehicles, tasks, and constraints. The solver returns optimized routes in seconds.

3

Use the results

Parse the response containing routes, stops, metrics, and quality scores. Export as GeoJSON for mapping.

Start the Guide 
curl -X POST https://api.routeopt.com/v1/optimize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicles": [{
      "id": "v1",
      "depot_id": "depot-1",
      "capacity": 100
    }],
    "tasks": [{
      "id": "task-1",
      "location": { "lat": 50.85, "lng": 4.35 },
      "demand": 20,
      "time_window": { "start": "08:00", "end": "12:00" }
    }],
    "depots": [{
      "id": "depot-1",
      "location": { "lat": 50.83, "lng": 4.37 }
    }]
  }'

Authentication

API KeyProgrammatic Access

For server-to-server integration. Create keys from the Settings page with fine-grained scopes.

Authorization: Bearer sk_live_...
JWTPortal Access

For the web portal and user-facing applications. Login with email/password to receive a JWT token.

POST /v1/auth/login

Scoped permissions: API keys support fine-grained scopes like optimize:write, jobs:read, analytics:read. See the full scope reference.

API Products

Core APIs for logistics optimization, analytics, and intelligence.

Route Optimization API

6 endpoints

Solve vehicle routing problems with time windows, capacities, skills, multi-depot support, and multi-objective optimization. The core of the platform.

Quick StartConceptsAPI ReferenceCode SamplesAPI Playground

Distance Matrix API

1 endpoint

Compute distance and duration matrices between multiple locations. Supports OSRM and multiple routing profiles for accurate drive-time calculations.

ConceptsAPI ReferenceCode Samples

Re-optimization API

1 endpoint

Incrementally update existing solutions when tasks change, new orders arrive, or vehicles become unavailable — without solving from scratch.

ConceptsAPI ReferenceCode Samples

Analytics API

3 endpoints

Access route analytics, efficiency trends, carbon footprint metrics, and AI-powered recommendations to continuously improve operations.

API ReferenceCode Samples

ML Predictions API

5 endpoints

Machine learning models that learn from your historical data to predict travel times, forecast demand, and detect anomalies in optimization results.

ConceptsAPI ReferenceCode Samples

Webhooks & Events API

5 endpoints

Subscribe to real-time events for optimization completion, route alerts, task completion, and more. Full delivery tracking and retry logic built in.

ConceptsAPI Reference

Additional APIs

AI Chat

4

Multi-turn conversational AI for optimization guidance

Reports

6

Scheduled report generation with templates and artifacts

Exports

1

Export job results in JSON, CSV, and GeoJSON formats

Billing & Usage

6

Usage tracking, invoices, and Stripe-powered payments

Portal Management

18

API keys, org members, invites, audit logs, GDPR compliance

Health Checks

2

Liveness and readiness probes with dependency status

Guides & Tools

Quick Start Guide

Start Here

Go from zero to optimized routes in under 5 minutes with our interactive walkthrough.

Concepts & Guides

Learn the fundamentals of VRP, time windows, capacities, ML-enhanced routing, and more.

API Playground

Try any endpoint interactively in your browser. Live requests with instant response inspection.

Code Examples

Copy-paste examples in Python, cURL, and JSON for every major use case.

Full API Reference

Complete endpoint documentation for all 50+ API routes with parameters and response schemas.

API Changelog

Version history, breaking changes, new features, and deprecation notices.

SDKs & Libraries

The RouteOpt API is a standard REST/JSON API that works with any HTTP client. Here are the recommended approaches for popular languages.

🐍

Python

pip install requests

Use requests or httpx for API calls. See Python examples.

⬢

Node.js

npm install node-fetch

Use fetch or axios. TypeScript types available.

🔵

Go

net/http (stdlib)

Standard library HTTP client works perfectly.

📟

cURL

curl -X POST ...

Command-line API testing. All examples include cURL.

Latest Changes

v2.8.0
Feb 13, 2026
Feature

Developer Portal Expansion

Interactive Quick Start guide, Concepts documentation, in-browser API Playground, and API Changelog.

v2.7.0
Jan 28, 2026
Feature

OSRM Route Geometry

Full route geometry now included in optimization responses via OSRM integration.

v2.6.2
Jan 15, 2026
Fix

Schema Alignment Fixes

Fixed billing, ML, analytics, and chat response schemas to match actual service outputs.

View full changelog

Keep building with RouteOpt

You are signed in. Launch the planner or keep exploring the documentation.

Open Route Planner Read the Quick Start