Skip to content

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