# roadUse on GET /search/2/reverseGeocode is deprecated

TomTom Maps APIs deprecated GET /search/2/reverseGeocode/*, query parameter roadUse without giving a shutdown date yet.

TomTom Maps APIs deprecated the roadUse query parameter on GET /search/2/reverseGeocode/* without a shutdown date. TomTom Maps APIs announced on September 19, 2023, that support for the roadUse parameter will be removed. Once removed, requests relying on this parameter fail.

## What to use instead

Stop filtering by roadUse. Instead, request returnRoadClass=Functional and filter on the roadClass array of the results.

- API: TomTom Maps APIs (api.tomtom.com)
- Kind: Parameter removal
- Announced: September 19, 2023
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /search/2/reverseGeocode/*`, `query parameter roadUse`
- Source: [Announcement](https://docs.tomtom.com/reverse-geocoding-api/documentation/tomtom-maps/v1/reverse-geocode)
- Verified: November 6, 2026, against TomTom Maps APIs's own pages
- Page: https://www.okapi.bot/providers/tomtom-maps-apis/breaking-changes/roaduse-on-get-search-2-reversegeocode-is-deprecated/

## TomTom Maps APIs's words

> Deprecated Support for the roadUse parameter will be removed.

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