Route Optimization API

Build mobility products on the same optimization core that runs 18M+ trips per year. Every capability in the platform is exposed as a REST API.

API Overview

What you'd build in-house in 18 months, available as endpoints

Mycelium's API-first architecture means every capability available in the UI is also accessible programmatically. Whether you want to embed route optimization into your logistics platform, build a custom dispatch workflow, or integrate dynamic pricing into your e-commerce checkout, the API gives you full control.

Authentication uses API keys issued per tenant. All endpoints accept and return JSON. The API supports both synchronous optimization for small batches and asynchronous processing with webhooks for large-scale operations.

Key API Capabilities

What you can build with the Mycelium API

Route Optimization

Submit orders with locations, time windows, and constraints. Receive optimized routes with stop sequences, ETAs, and load plans. The VRPTW solver handles dozens of simultaneous constraints and returns results in seconds.

POST /api/v1/optimize

Order Management

Create, update, and track orders through their lifecycle. Import orders individually, in batches, or via scheduled data feeds. Each order supports custom fields, priority levels, and constraint overrides.

POST /api/v1/orders   GET /api/v1/orders/{id}

Dispatch Automation

Trigger automatic dispatch to drivers, fleets, or third-party carriers. Configure dispatch rules, cutoff times, and carrier selection logic. Receive status updates via webhooks as routes progress.

POST /api/v1/dispatch   GET /api/v1/routes/{id}/status

Dynamic Pricing

Calculate ride or delivery prices based on configurable rules. Factor in distance, zones, time of day, vehicle type, and custom surcharges. Get price quotes before committing to routes.

POST /api/v1/pricing/quote

Fleet and Driver Management

Manage vehicles, drivers, and their availability. Set vehicle capacities, driver skills, working hours, and territory assignments. The optimizer uses this data to build feasible, balanced routes.

GET /api/v1/vehicles   PUT /api/v1/drivers/{id}

Address Resolution and Travel Time

Resolve addresses to coordinates and calculate travel times between points. Travel time calculations factor in real-time and historical traffic patterns to ensure routing decisions reflect actual road conditions.

POST /api/v1/geocode   POST /api/v1/distance-matrix

How It Works

Submit orders and vehicles, get optimized routes back in seconds

The typical integration flow is straightforward. Your application sends a set of orders (with addresses, time windows, and constraints) and available vehicles (with capacities, depots, and working hours) to the optimization endpoint. Mycelium's VRPTW solver computes optimal routes and returns them with stop sequences, ETAs, load plans, and performance metrics.

For small batches, the API responds synchronously in under a second. For large-scale operations with hundreds of orders, asynchronous processing with webhook callbacks ensures your application isn't blocked while optimization runs.

Request API access to receive full documentation, sandbox credentials, and integration support from our engineering team.

Integration Patterns

How companies integrate with the Mycelium API
Optimization as a Service

Send orders and vehicles, get optimized routes back. The simplest integration pattern. Your application handles the UI and workflow; Mycelium handles the math. Most customers start here.

Full Lifecycle Automation

Use the complete API surface to manage orders, optimize, dispatch, track, and report. Webhooks notify your system of status changes. This pattern replaces manual dispatch operations entirely.

White-Label Embedding

Embed Mycelium's optimization and apps under your own brand. The API supports full white-labeling with custom branding, domains, and user management. Your customers never see Mycelium.

For Integration Partners

Embed Mycelium inside your product, white-label our complete platform, or compose specific capabilities via API

Mycelium powers transportation operations inside other platforms. Our largest partner uses Mycelium across their entire stack. Optimization API for self-service clients. Complete white-label deployment for enterprise customers with export to multiple vendors. Internal team transport. The backbone of their international operations. And as the core technology demo that helps them win new sales.

Whether you want to embed our optimization engine inside your existing product, white-label our complete platform under your brand, or compose specific capabilities via API, we have a partnership model to fit. Our partners maintain full client relationships while our intelligence runs at scale behind the scenes.

Discuss a Partnership

Ready to integrate route optimization?

Request API access and receive full documentation, sandbox credentials, and integration support from our engineering team.

Request API Access