Build on the routing API that re-routes live.
Routing, re-routing, matrices, multi-stop optimisation, geocoding, and live asset tracking, one thin API. The route holds when conditions change: a full re-plan on a comparable scale completes in single-digit milliseconds (200-stop day: 4.6 ms, TR-2026-01), and an incremental reroute after a traffic change completes in 0.0037 ms versus 1.1185 ms for a full recompute, a 302× reduction (TR-2026-02). Embed our map UI or bring your own tiles. The same incremental step also transmits ~80% less data per route change, verified byte-for-byte. Enter your email, get a key in seconds, and run the curl below to test it now.
Get your API key
Why trust a key from a small company? Two things you can check yourself: the founder was the fastest riser on the public GIMPS top-500 leaderboard on the capture date (up 130 places in 24 hours, against 55 for the next-fastest), full standing at mersenne.org, and the service behind this API runs from one small server, the same engine we run our own business on.
Your key
Send it as the X-API-Key header.
Trial (7 days): 25 000 routes/month, 2 requests/second. During the open beta the API is rate-limited and you can try it without a key; we may require a key at any time, and production use requires one.
curl -s https://route.elara-cortex.com/v1/route \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_KEY" \
-d '{"from":[-26.1076, 28.0567], "to":[-26.2041, 28.0473]}'
✓Account created, here's your key
Manage keys & billing in your account →
Optional: add your mobile
Get an SMS before you hit your monthly limit, and open the priority low-latency lane in the mobile app. We will never market to you.
Endpoints
| Method | Path | What it does |
|---|---|---|
| POST | /v1/route | A→B road route: distance, turn-by-turn steps, geometry, alternatives, live ETA & incidents. Plan code: ELRT-API-ROAD |
| POST | /v1/drone/route | Drone Routing API. Air routing, follows drone corridors where they exist, else flies direct; bounded by range and no-fly zones. ELRT-API-DRONE |
| POST | /v1/maritime/route | Maritime Routing API. Sea routing between coastal/offshore points a road route cannot reach. ELRT-API-MARINE |
| POST | /v1/av/route | Self-Driving (AV) Routing API. Preview-only road geometry, restricted to mapped and permitted autonomous operational design domains. Outside the current ODD it returns 422 instead of engaging. ELRT-API-AV |
| POST | /v1/reroute | Small updates. When traffic or a stop changes, we send only what changed, typically a compact delta (measured at approximately 80% smaller payload on change, bench_pack_results.json; cold path may call upstream routing). |
| POST | /v1/matrix | Distance/time matrix between many points (dispatch, clustering). |
| POST | /v1/optimise | Best multi-stop order (single or multi-vehicle), fleet routing. |
| GET | /v1/geocode?q= | Address → coordinates (global, local-first cache). |
| GET | /v1/reverse?lat=&lon= | Coordinates → address. |
| GET | /v1/nearby?lat=&lon=&category= | Nearby fuel, food, parking, charging, hospitals… |
| GET | /v1/account/usage | Your plan, quota and usage (send your key). |
| POST | /v1/assets | Register an asset (drone, vehicle, robot). Category military available for gov/defence accounts. |
| GET | /v1/assets | List your assets and live-tracking limits for your subscription. |
| POST | /v1/assets/{id}/route | Plan and attach a route to that asset (same engine as /v1/route). |
| POST | /v1/assets/{id}/position | Ingest live GPS, optional battery_pct, heading. |
| GET | /v1/assets/{id}/live | Live position vs planned route. X-Elara-Live-Channel: web|api, poll rate capped by plan. |
Live tracking tiers (beta)
| Plan | Web polls/s | API live polls/s | GPS push/s | Max assets |
|---|---|---|---|---|
| trial | 0.2 | - | - | 5 |
| starter | 1 | 0.5 | 0.5 | 30 |
| pro | 2 | 2 | 2 | 500 |
| aviation | 2 | 10 | 10 | 200 |
| military | 2 | 10 | 10 | 200 |
Aviation & military: 10 Hz API live feed and 10 Hz GPS ingest on dedicated/VPS deploys.
Issue keys: python auth.py create aviation or military (not self-serve signup).
Watch assets on the live tracking page after you sign in, same API key. Enterprise / aviation / military: book a briefing (10 Hz live track on dedicated host).
Errors, SLA and support
| Code | Meaning | What to do |
|---|---|---|
| 400/422 | Request cannot be routed as sent: missing fields, non-numeric coordinates, out-of-range coordinates, null island, or outside the AV ODD. | Fix the request; do not retry unchanged. |
| 401/403 | API key missing, expired or not allowed for the endpoint. | Create a key in your account or contact support. |
| 429 | Rate limit hit. Trial/beta anonymous traffic has a burst allowance; production keys are metered by plan. | Back off using Retry-After, or use an API key. |
| 502/503 | Temporary upstream or capacity edge. | Retry after the indicated delay; persistent cases are treated as support issues. |
Support: email hello@elara-cortex.com with the endpoint, timestamp, request shape and response code. SLA: public beta is best-effort; paid enterprise/dedicated deployments get written availability and response terms in the service order. OpenAPI: /openapi.json.
Example, optimise a delivery run
POST /v1/optimise
{ "stops": [[-26.10, 28.05], [-26.20, 28.04], [-26.15, 28.10], [-26.08, 28.02]], "vehicles": 1 }
→ { "order": [0, 3, 1, 2], "distance_km": 41.2, "solve_ms": 0.6 }
Built for these
Couriers & last-mile
From single-developer projects to large fleet operators, /optimise + tiny /reroute on traffic.
Motorcycle & moped
Battery + LTE + on-route: push GPS, poll live vs plan (Pro up to 2/s).
Fleets & logistics
/matrix + live /v1/assets, stay on corridor globally.
Drones
Small packets on patchy links; /track for ops vs plan.
Hobby & indie devs
Embed our map, skip building a full mapping layer.
Autonomy R&D
High-fidelity distances + fast traffic reroute, kernel only, not homologation.
Predictable, usage-based pricing on one routing API.
Deterministic, mathematically specified routing, so the route you build on stays solid. 14-day trial to start. Email sign-in now; Google sign-in coming. Pricing is by speed tier; see pricing.