routebase the recurring route planning API

Plan the rhythm, not just the route.

State-of-the-art VRP optimization with robust models for scheduling, frequency planning and workload balancing, behind one JSON contract.

8,290 stops 1,150 routes 13 weeks 4 regions 65 min to plan
01

The map sheet: one production quarter

51.5°N 52.0°N 52.5°N 53.0°N 4.0°E 4.5°E 5.0°E 5.5°E 6.0°E 6.5°E 7.0°E N O W Z DEPOT SCALE 30 MIN ≈ 33 KM WK 27–39 · ROUTES PER REGION REGION N 286 REGION O 260 REGION W 331 REGION Z 273
kaartblad RB-29-01production quarter · wk 27–39 · 4 regions
scale30 min ≈ 33 km
revB
date2026-07
source606 addresses · OSRM Benelux · HERE

Every line is a driven leg from the quarter that started 29 June 2026, drawn straight from stop to stop. One ink per region; line weight is frequency: weekly legs print heavy, four-weekly visits stay hairlines. 257,601 km of driving, planned by one POST.

02

The working timetable: the same fortnight, as your crews read it

wkmo tu we th frtask servicerouteday load
27··· Station cleaning, Amersfoort · 2×/wk 35 minN-2 · N-4
27···· Station cleaning, Nieuw-Vennep · weekly 30 minN-4
27···· Station cleaning, Europoort–Maasvlakte · every 2 wks 60 minW-1
27···· Car wash, Assen · every 2 wks  40 minO-2
27···· Station cleaning, Breda · every 4 wks 45 minZ-3
28··· Station cleaning, Amersfoort · same days, next week 35 minN-1
28···· Station cleaning, Nieuw-Vennep · same day, same route 30 minN-4
28····· Europoort–Maasvlakte, rest week (wk mod 2 = 1)
28····· Assen, rest week (wk mod 2 = 1)
28····· Breda, next visit wk 31 (wk mod 4)

  Tue wk 27 runs at reduced crew: the vehicle calendar says so, the plan follows. Rows are real assignments from the run behind the map sheet: wk 27–28, regions N/O/W/Z. The load column is the point: week totals level to within 2%.

weekly
every 2 weeks · phase 0
every 4 weeks · phase 2
03

Product register

04

The difference

Every routing API plans the day you hand it. Routebase decides the days.

day APIsDay-route optimizers pack the stops you already scheduled into routes the calendar is your problem
suitesEnterprise planning suites do plan recurrence (behind a sales cycle, seats and consultants) not one endpoint
solversSolver frameworks can model anything, if you do the modeling, tuning and infra a toolkit, not an answer

Routebase is the layer in between: the recurring schedule itself (weekday, week, rhythm) decided for you, behind one JSON contract. Day routing is included, downstream.

05

JSON in, plan out

json in · POST /v1/recurring-plans
$ curl -X POST https://api.routebase.nl/v1/recurring-plans \
    -H "Authorization: Bearer rb_…" \
    -d @quarter.json

# quarter.json
{
  "tasks": [ … 8,290 rows: address, service_min,
             frequency, allowed weekdays … ],
  "config": {
    "vehicles": { "vehicles_per_day": 4,
                  "max_route_minutes_hard": 570 },
    "effort": "max"
  }
}
plan out · GET /v1/jobs/{id}
{
  "status": "ok",
  "horizon": { "start": "2026-06-29", "weeks": 13 },
  "plan": {
    "assignments": [
      { "task_id": "1-W1-a",
        "date": "2026-06-29", "route": "N-2" },
      … every task, dated and routed …
    ],
    "routes_by_day": [ … 1,150 routes … ]
  },
  "metrics": { "drive_min": 190062, "solve_s": 3888 }
}

One POST for the quarter; day planning, single routes and detour ranking are the same story at smaller scale. Contracts are JSON Schema: the same files the validator runs, so the docs cannot drift. Want to try it without an account? The sandbox ships a ready-to-POST day (rb_demo_sandbox, no signup) and the full 4-week recurring problem.

06

Measured, not promised

"(Near-)best-in-class" is the claim. These are the measurements.

0 min
overtime
−14.5%
drive time
0
routes over the 570-min cap

Scenario against the running plan, same task set, re-costed with HERE, measured 2026-07-06. Claims on this page are numbers with units; if we can't measure it, it isn't here.

The full sheet: guarantees & benchmarks → · gaps against public best-known solutions, head-to-head, stability under 5% churn, scale.

07

For agents

The second customer never reads a homepage. When someone asks their agent for complex route planning, the answer has to already be indexed, in the formats agents actually read.

sandboxTry it now, no signup 300 synthetic locations on real roads · demo key rb_demo_sandbox · sync endpoints /static/site/sandbox/
mcpPlan from inside the conversation five semantic tools: sandbox demo, day plan, recurring plan, job poll, detour ranking routebase mcp · remote next
llms.txtThe product, agent-readable what it plans, when to reach for it, one example per product /llms.txt openapi.jsonEvery endpoint, generated from the running app, cannot drift /v1/openapi.json
*.schema.jsonThe contracts themselves the files the validator runs; the reference is generated from them ships with the docs
routebase · made in the Netherlands type: Archivo & IBM Plex Mono api v0.1.0