Geocoding — entry 072 of 80

TomTom

Verified Jul 2026

TomTom's Geocoding API converts addresses and place names into coordinates and back, drawing on TomTom's own commercial map data rather than open datasets like OSM, and sits alongside its routing, traffic, and search products. TomTom is steering new integrations toward its newer Orbis Maps platform while keeping this legacy Maps/Geocoding API live and documented. New accounts get 20,000 free geocoding requests a month with no card required, with metered paid tiers above that.

geocodingmapsaddress-lookupfreemium

Visit developer.tomtom.com ↗Read the docs ↗Pricing ↗More Geocoding

AuthenticationAPI KeySign up with the provider to obtain credentials.

HTTPSSupportedTraffic is encrypted in transit.

CORSEnabledCallable directly from browser JavaScript.

PricingFreemiumA usable free tier exists, with paid plans for more volume.

FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score81out of 100

Authentication15/25API key required

Pricing17/20Freemium tier available

Docs20/20Machine-readable spec file bundled

Formats9/15Single response format

Freshness20/20Verified within 6 months

Embed this badge

<a href="https://greatapis.com/api/tomtom/"><img src="https://greatapis.com/badge/tomtom.svg" alt="Scored 81 on greatapis.com"></a>

Auth quickstart

Get a key at the provider
Send it on every request as a query param?key=<key>

Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers

https://api.tomtom.com

Auth

api_key

Additional Data1

GET/search/{versionNumber}/additionalData.{ext}Additional Data

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`ext`	path	yes	string
`geometries`	query	yes	string
`geometriesZoom`	query	no	integer

Responses

Status	Description	Schema
`200`	OK: additional data were retrieved and the body of the response contains requested data.	—
`400`	Bad request: one or more parameters(i.e. geometries, ext) were incorrectly specified.	—
`403`	Permission, capacity, or authentication issues: - Forbidden - Not authorized - Account inactive - Account over queries per second limit - Account over rate limit - Rate limit exceeded	—
`404`	Not Found: the requested resource could not be found, but it may be available again in the future.	—
`405`	Method Not Allowed: the client used a HTTP method other than GET.	—
`408`	Request timeout.	—
`414`	Requested uri is too long.	—
`500`	An error occurred while processing the request. Please try again later.	—
`502`	Internal network connectivity issue.	—
`503`	Service currently unavailable.	—
`504`	Internal network connectivity issue or a request that has taken too long to complete.	—
`596`	Service not found.	—

Filters4

GET/search/{versionNumber}/geometryFilter.{ext}Geometry Filter

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`ext`	path	yes	string
`geometryList`	query	yes	string
`poiList`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

POST/search/{versionNumber}/geometryFilter.{ext}Geometry Filter

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`ext`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/routedFilter/{position}/{heading}.{ext}Routed Filter

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`position`	path	yes	string
`heading`	path	yes	number
`ext`	path	yes	string
`poiList`	query	yes	string
`routingTimeout`	query	no	integer

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

POST/search/{versionNumber}/routedFilter/{position}/{heading}.{ext}Routed Filter

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`position`	path	yes	string
`heading`	path	yes	number
`ext`	path	yes	string
`routingTimeout`	query	no	integer

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

Geocoding2

GET/search/{versionNumber}/geocode/{query}.{ext}Geocode

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`storeResult`	query	no	boolean
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/structuredGeocode.{ext}Structured Geocode

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`ext`	path	yes	string
`countryCode`	query	yes	string
`limit`	query	no	integer
`ofs`	query	no	integer
`streetNumber`	query	no	string
`streetName`	query	no	string
`crossStreet`	query	no	string
`municipality`	query	no	string
`municipalitySubdivision`	query	no	string
`countryTertiarySubdivision`	query	no	string
`countrySecondarySubdivision`	query	no	string
`countrySubdivision`	query	no	string
`postalCode`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

Reverse Geocoding2

GET/search/{versionNumber}/reverseGeocode/crossStreet/{position}.{ext}Cross Street lookup

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`position`	path	yes	string
`ext`	path	yes	string
`limit`	query	no	integer
`spatialKeys`	query	no	boolean
`heading`	query	no	number
`radius`	query	no	integer
`language`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/reverseGeocode/{position}.{ext}Reverse Geocode

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`position`	path	yes	string
`ext`	path	yes	string
`spatialKeys`	query	no	boolean
`returnSpeedLimit`	query	no	boolean
`heading`	query	no	number
`radius`	query	no	integer
`number`	query	no	string
`returnRoadUse`	query	no	boolean
`roadUse`	query	no	string
`callback`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

Search10

GET/search/{versionNumber}/cS/{category}.{ext}Low Bandwith Category Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`category`	path	yes	string
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`idxSet`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/categorySearch/{query}.{ext}Category Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/geometrySearch/{query}.{ext}Geometry Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`geometryList`	query	no	string
`limit`	query	no	integer
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`idxSet`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

POST/search/{versionNumber}/geometrySearch/{query}.{ext}Geometry Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`limit`	query	no	integer
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`idxSet`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/nearbySearch/.{ext}Nearby Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`ext`	path	yes	string
`lat`	query	yes	number
`lon`	query	yes	number
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`minFuzzyLevel`	query	no	integer
`maxFuzzyLevel`	query	no	integer
`idxSet`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/poiSearch/{query}.{ext}Points of Interest Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/routedSearch/{query}/{position}/{heading}.{ext}Routed Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`position`	path	yes	string
`heading`	path	yes	number
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`multiplier`	query	no	integer
`routingTimeout`	query	no	integer
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`idxSet`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/s/{query}.{ext}Low bandwith Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`idxSet`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

GET/search/{versionNumber}/search/{query}.{ext}Fuzzy Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`typeahead`	query	no	boolean
`limit`	query	no	integer
`ofs`	query	no	integer
`countrySet`	query	no	string
`lat`	query	no	number
`lon`	query	no	number
`radius`	query	no	integer
`topLeft`	query	no	string
`btmRight`	query	no	string
`language`	query	no	string
`extendedPostalCodesFor`	query	no	string
`minFuzzyLevel`	query	no	integer
`maxFuzzyLevel`	query	no	integer
`idxSet`	query	no	string
`view`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

POST/search/{versionNumber}/searchAlongRoute/{query}.{ext}Along Route Search

Parameters

Name	In	Required	Type
`versionNumber`	path	yes	integer
`query`	path	yes	string
`ext`	path	yes	string
`maxDetourTime`	query	yes	integer
`limit`	query	no	integer

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`400`	—	—
`403`	—	—
`405`	—	—
`596`	—	—
`5XX`	—	—

Try it

Operation

API key

Developer reference

Base URLhttps://api.tomtom.com

Rate limit

Free tier: per-API monthly allowances (e.g. ~20,000 geocoding calls/month); TomTom is revising this pricing structure as of July 2026

Key endpoints

GET/search/{versionNumber}/geocode/{query}.{ext}
GET/search/{versionNumber}/structuredGeocode.{ext}
GET/search/{versionNumber}/reverseGeocode/{position}.{ext}
GET/search/{versionNumber}/poiSearch/{query}.{ext}
GET/search/{versionNumber}/search/{query}.{ext}

SDKs

JavaScript ↗

Changelog

Spec version1.0.0

Tracked paths16

No change recorded yet.

Tracking since Sep 2026. See every tracked change ↗ ·Subscribe with RSS ↗

Featured in

2 collections

Spec-backed APIs CORS-ready browser APIs

GreatAPIs Score

Embed this badge

Auth quickstart

Endpoints

Try it

Developer reference

Changelog

Featured in

People comparing TomTom also look at…

Cartes.io

API Découpage Administratif (API Geo)

GeoJS

OpenStreetMap

adresse.data.gouv.fr

Ducks Unlimited