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. It generates correct code on the first try.
Find your integration pattern.
End-to-end walkthroughs organized by how your operation actually runs. Each one opens with a one-paragraph profile, so you know in seconds which is yours.
Nightly batch for 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 for pickups and 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-daySame-day grocery 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 for 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 delivery management platform for last-mile operations: plan, dispatch, track, and prove deliveries from one system.
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 get 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. It generates correct code on the first try.