GET reverse

openstreetmap.org:nominatim-api

Summary: Reverse Geocoding
Operation ID: reverse
Auth: unknown
Description

Convert latitude/longitude coordinates to an address.

Parameters (18)

accept-language (string, query, optional)

Preferred language for results

addressdetails (integer, query, optional, default: 1)

Include address breakdown (0 or 1)

Constraints: {'enum': [0, 1]}

debug (integer, query, optional, default: 0)

Return HTML debug info (0 or 1)

Constraints: {'enum': [0, 1]}

email (string, query, optional)

Contact email (required for heavy usage)

entrances (integer, query, optional, default: 0)

Include tagged entrances (0 or 1)

Constraints: {'enum': [0, 1]}

extratags (integer, query, optional, default: 0)

Include additional OSM tags (0 or 1)

Constraints: {'enum': [0, 1]}

format (string, query, optional, default: jsonv2)

Response format

Constraints: {'enum': ['xml', 'json', 'jsonv2', 'geojson', 'geocodejson']}

json_callback (string, query, optional)

JSONP callback function name

lat (number, query, required)

Latitude in WGS84 projection

Constraints: {'minimum': -90, 'maximum': 90}

layer (string, query, optional)

Comma-separated layer filters: address, poi, railway, natural, manmade

lon (number, query, required)

Longitude in WGS84 projection

Constraints: {'minimum': -180, 'maximum': 180}

namedetails (integer, query, optional, default: 0)

Include full list of names (0 or 1)

Constraints: {'enum': [0, 1]}

polygon_geojson (integer, query, optional, default: 0)

Return geometry as GeoJSON (0 or 1)

Constraints: {'enum': [0, 1]}

polygon_kml (integer, query, optional, default: 0)

Return geometry as KML (0 or 1)

Constraints: {'enum': [0, 1]}

polygon_svg (integer, query, optional, default: 0)

Return geometry as SVG (0 or 1)

Constraints: {'enum': [0, 1]}

polygon_text (integer, query, optional, default: 0)

Return geometry as WKT (0 or 1)

Constraints: {'enum': [0, 1]}

polygon_threshold (number, query, optional, default: 0.0)

Simplify geometry tolerance in degrees

zoom (integer, query, optional)

Zoom level for address detail (0-18). Higher = more detail.

Constraints: {'minimum': 0, 'maximum': 18}

Examples (3)

TitleTypeURLAction
Reverse Geocoding openapi-spec https://nominatim.openstreetmap.org/reverse?lat=52.5170365&lon=13.3888599
Reverse Geocoding openapi-spec https://nominatim.openstreetmap.org/reverse?lat=51.5074&lon=-0.1278
Reverse Geocoding probe-gate https://nominatim.openstreetmap.org/reverse?lat=51.5074&lon=-0.1278&format=json&addressdetails=0&extratags=0&namedetails=0&zoom=18

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:47:35.341498 200 300ms
2026-03-23 10:31:18.480660 200 290ms
2026-03-23 09:16:06.066473 200 1344ms

Response Changes

WhenOldNew
2026-03-23 10:31:18.480660 ef9b5eab72d7 189cd41acb3a
2026-03-23 10:47:35.341498 189cd41acb3a 46eb00a447f2