FAQ¶
Resources
Is the API synchronous?
No — it's submit-and-poll. POST returns a 202 + id immediately; you GET that id until it returns 200. See How optimization works.
How do I get an API key?
Keys are issued by DDS Wireless. Contact your rep or the Scheduled Routes API page. See Authentication.
Do I send addresses or coordinates?
Coordinates — [lat, lng] (or {lat, lng}), with at least 5 decimal places. The API doesn't geocode addresses.
Why are some of my jobs unassigned?
The solve succeeded but couldn't place them — usually a time window, capacity, or skill constraint, or an unreachable location. Turn on unassignedTasks to see reasons. See Rate limits and errors.
How big a problem can I send?
Large fleets and thousands of stops are supported; bigger problems just take longer to solve (poll with backoff). The total time span of a problem is capped at 33 hours.
How do I re-plan mid-day?
Re-submit as a new problem that includes each vehicle's lastKnownLocation and each task's status. See Re-optimization.
Does 'Try it out' in the docs cost anything or touch live data?
It calls production with the key you paste, under your account. Use a test key/tenant and non-sensitive data. See Testing and access.
What timezones should I use?
ISO 8601 with an offset, consistent across the whole payload. The solution comes back in the same timezone you send.
Related: Quickstart · Glossary · Operations