Routing APIs

All the routingAPIs you need

Multi-stop optimization, distance matrices, snap-to-road, and more. A complete routing toolkit for any mobility software.

Get API access API Reference

The challenge

Routing is complex infrastructure

-Multi-stop optimization is NP-hard - not a weekend project
-Every constraint multiplies complexity: time windows, capacity, attributes
-Standard mapping APIs stop at point-to-point directions
-Building and scaling route optimization is a team and a roadmap

Our approach

We handle the hard part

✓Production-grade VRP/TSP optimization, ready to use
✓Six endpoints covering the full routing lifecycle
✓Constraints built in: time windows, SLAs, capacity, attributes
✓Scales from 10 jobs to 10,000 - same simple API

Capabilities

Enterprise-grade routing

Everything you need to build optimized routing into your dispatch or fleet management software.

Shared Rides

Group compatible passengers into shared trips. Control max passengers, ride time ratios, and who can share with whom via profiles.

Time Windows

Pickup and drop-off windows with configurable early/late tolerances. Maximum ride times that scale with trip distance.

Attributes

Wheelchair, child seat, gurney, language - any requirement. Attributes affect capacity, boarding time, and sharing rules.

Traffic Aware

Hourly multipliers, departure-based ETAs, toll avoidance

Stop Clustering

Snap nearby stops together, reduce walking distance

Service Areas

Geographic zones with custom routing rules

Service Profiles

Define which profiles can share rides together

Endpoints

Six endpoints. Full control.

POST/routing/createasync

Create Routes

Batch optimize thousands of jobs into trips. Returns a production ID for async polling.

GET/routing/result/{id}

Get Route Result

Retrieve optimized trips with stops, ETAs, route geometry, and any unrouted jobs.

POST/routing/single

Single Route

Calculate route geometry and duration for a fixed sequence of coordinates.

POST/routing/tsp

Optimize Stop Order

Find the optimal ordering of stops using TSP algorithms. Fixed start/end supported.

POST/routing/matrix

Distance Matrix

Calculate distances and durations between multiple origins and destinations.

POST/routing/snap

Snap to Road

Snap GPS coordinates to the nearest road. Correct drift and align points to the road network.

Stateless Design

Simple to integrate

No persistent state to manage. Send your data, get results back. Integrate with any dispatch system, fleet software, or custom application.

Async for batch optimization

Submit large batches, poll for results. No timeouts.

50+ configurable settings

Max trip duration, passenger limits, boarding times, clustering, and more.

Route trajectory included

Encoded polyline geometry for every trip. Map-ready output.

Unrouted jobs returned

Know exactly which jobs couldn't be routed and why.

create-routes.json

POST /api/v1/routing/create
{
  "jobs": [
    {
      "id": "job_1",
      "from": { "lat": 40.7128, "lng": -74.0060 },
      "to": { "lat": 40.7580, "lng": -73.9855 },
      "pick": "2024-03-15T09:00:00Z",
      "seats": 2,
      "attr": ["wheelchair"]
    },
    {
      "id": "job_2",
      "from": { "lat": 40.7200, "lng": -74.0100 },
      "to": { "lat": 40.7614, "lng": -73.9776 },
      "pick": "2024-03-15T09:15:00Z",
      "seats": 1
    }
  ],
  "settings": {
    "maxTripDuration": 90,
    "maxPassengersAtOnce": 4,
    "sharedRideRatio": 1.5
  }
}

Use cases

Power any routing workflow

Dispatch Systems

Add multi-stop optimization to your existing dispatch software. Replace manual route building with API calls.

Shared Mobility

NEMT, shuttles, paratransit. Group passengers with compatible needs into efficient shared rides.

Delivery Operations

Optimize stop sequences for delivery routes. Time windows, service durations, and capacity constraints.

Ready to buildwith our APIs?

Get API access and start building. Whether you need multi-stop optimization, distance matrices, or snap-to-road - we've got you covered.

Get API access Read the docs