v4
latestOpenAPI 3.1.0Proprietary2026-08-034715226.2 KBRefetch a saved route with re-evaluated warnings
Returns the previously-computed route with warnings[] re-run against current data. Does NOT count against routing quota, but is subject to a separate refetch rate limit (1 / 30 s per route, 60 / minute per customer; both configurable). A 15-second refetch cache absorbs the dispatcher's tweak-and-re-evaluate flow.
Auto-saved routes (is_persisted=false) expire 30 minutes after the original routing call. After that, this endpoint returns route_expired.
Pass route_index=N to refetch warnings for an alternative route. The response always carries exactly one route in routes[]; the original request's other alternatives are still available via repeat calls with different route_index values, but each response shows only the one you asked for. Each route_index caches independently.
Path parameters
Query parameters
Zero-based index of the route to refetch. 0 is the primary (default). Valid range is 0 ≤ N < len(routes) against the saved row's stored response. Out-of-range returns invalid_route_index (400).
Response
Route returned (warnings re-evaluated). routes[] is a single-element array carrying the chosen route_index.