The routing brain for your ERP.
Send stops from SAP, Dynamics 365, Navision, Odoo — or any system that speaks JSON. Get optimized routes back, dispatch to drivers, and reconcile completions through webhooks.
From key to first call in two steps.
- 1
Secure your API key
Every request is authenticated with a private API key. Generate and rotate keys in the API Keys section of your planner dashboard.
- 2
Make your first request
Pass your key as the
private_keyquery parameter. Try the snippets on the right to verify your connection.
curl -G 'https://api.routal.com/v2/vehicles' \
--data-urlencode 'private_key=xxxxxxxxxxxxx' \
-H 'Content-Type: application/json'Your AI assistant already knows Routal.
Drop our llms.txt into Cursor, Claude, Windsurf, or any AI-augmented editor. The model gets the full Routal context — endpoints, gotchas, mental model — and generates correct code on the first try.
Find your integration pattern.
End-to-end walkthroughs organized by how your operation actually runs. Each opens with a one-paragraph profile so you can self-identify in seconds.
Nightly batch — B2B distribution
Orders close yesterday at 18:00, optimization runs overnight, fleet rolls out at dawn.
Open recipeHybridNightly batch + live dispatch
Most work is the nightly batch, but new orders keep arriving during operations.
Open recipeConstrained loadsCapacitated distribution
Weight, volume, cold chain, oversized loads. The optimizer respects every constraint.
Open recipePickups & returnsReverse logistics — pickups & returns
Pickup routes, RMA flow, mixed delivery + pickup chained on the same visit.
Open recipeB2C parcelsLast-mile e-commerce
B2C parcels with customer tracking. High stop count, automated SMS/email via the customers app.
Open recipeSame-dayGrocery — same-day delivery
Dark stores and same-day grocers. Wave optimization, cold-chain enforcement, sub-2-hour SLAs.
Open recipeField serviceField service with appointments
Technicians, installers, mobile workforce. Skill-matched assignment, tight time windows.
Open recipeCalendar-drivenRecurring services
Calendar-driven dispatch — ITV, gas, elevators, maintenance. The schedule itself is the product.
Open recipeQuestions developers ask first.
How do I authenticate with the Routal API?
Every request is authenticated with a private API key passed as the private_key query parameter. Generate and rotate keys in the API Keys section of your planner dashboard at planner.routal.com.
What is the base URL and current version?
The base URL is https://api.routal.com and the current version is v2 — for example, https://api.routal.com/v2/vehicles.
What can I do with the API?
Create and manage plans, stops, routes, and vehicles programmatically, track deliveries in real time, and retrieve proof of delivery. Routal is a route-optimization and last-mile delivery platform.
Does Routal support webhooks?
Yes. Subscribe to delivery lifecycle events to reconcile completions and proof of delivery in your own system as routes are executed.
Are there rate limits?
Yes. Requests are rate-limited per credential — currently 2,000 requests per minute per API key. If you exceed it you receive a 429 Too Many Requests response; back off and retry with exponential backoff.
How do I integrate the API with AI tools and coding agents?
Point your AI editor (Cursor, Claude, Windsurf) at developers.routal.com/llms.txt or llms-full.txt. The model gets the full Routal context — endpoints, gotchas, and mental model — and generates correct code on the first try.