# Route v1 directions stops working

Calls to /route/directions/* on Azure Maps stop working on March 31, 2028.

On March 31, 2028, Azure Maps will retire Route v1 directions endpoints. After this date, requests to /route/directions/* will fail. Calls must be transitioned to the newer service version to avoid disruptions.

## What to use instead

Update requests to call POST /route/directions?api-version=2025-01-01 with a GeoJSON body. Send batch requests to /route/directions:batch instead.

- API: Azure Maps (atlas.microsoft.com)
- Kind: Version retirement
- Takes effect: March 31, 2028
- Calls after that day: fail
- Calls it hits: `/route/directions/*`
- Source: [Announcement](https://learn.microsoft.com/en-us/rest/api/maps/route/get-route-directions?view=rest-maps-1.0)
- Verified: November 6, 2026, against Azure Maps's own pages
- Page: https://www.okapi.bot/providers/azure-maps/breaking-changes/route-v1-directions-stops-working/

## Azure Maps's words

> The Azure Maps Route v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Route v1 service will need to be updated to use Route v2025-01-01 service by 3/31/28.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent