This is a deprecation notice - we are changing or removing support for the features described on this page on or after October 7, 2026. Please ensure to adjust your integrations accordingly before that date.

Route optimization requests carrying more than 10 stops are deprecated on Optimize Route and will be rejected from 2026-10-07. Every integration that sends large problems has to move to the asynchronous flow announced in Optimize large routes without waiting on the request, which explains how to submit an optimization and fetch its result.

Smaller optimizations are unaffected. If your integration stays below the limit, nothing changes for you and there is nothing to do.

Why

Optimize Route solves the problem while your request waits. Our routing provider treats solving-while-you-wait as a small-problem operation and stops it after a few seconds, so a 50-stop tour can legitimately need longer than the endpoint is allowed to take — and comes back as an error rather than as a slower answer.

Until 2026-10-07

Oversized requests keep being answered synchronously during the migration period, so nothing breaks while you make the change. Each such response carries a Sunset header naming the date they stop working, alongside a Link header pointing back at this post — a straightforward way to check whether any of your calls are affected.