GET /lookup
openstreetmap.org:nominatim-api
Summary: Address Lookup by OSM IDs
Operation ID: lookup
Auth: unknown
Operation ID: lookup
Auth: unknown
Description
Look up addresses by OpenStreetMap node, way, or relation IDs. Returns full address information for up to 50 OSM objects.
Parameters (15)
accept-language
(string, query, optional)
Preferred language for results
addressdetails
(integer, query, optional, default: 0)
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
namedetails
(integer, query, optional, default: 0)
Include full list of names (0 or 1)
Constraints: {'enum': [0, 1]}
osm_ids
(string, query, required)
Comma-separated OSM IDs with type prefix: N (node), W (way), R (relation). Max 50 IDs.
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
Examples (4)
| Title | Type | URL | Action |
|---|---|---|---|
| OSM Object Lookup | openapi-spec |
https://nominatim.openstreetmap.org/lookup?osm_ids=R175342,W12345 |
|
| OSM Object Lookup | probe-gate |
https://nominatim.openstreetmap.org/lookup?osm_ids=R175342%2CW12345&format=json&addressdetails=0&extratags=0&namedetails=0 |
|
| Address Lookup by OSM IDs | openapi-spec |
https://nominatim.openstreetmap.org/lookup?osm_ids=N240109189,W12345678 |
|
| Address Lookup by OSM IDs | probe-gate |
https://nominatim.openstreetmap.org/lookup?osm_ids=N240109189%2CW12345678&format=jsonv2&addressdetails=0&extratags=0&namedetails=0&entrances=0&polygon_geojson=0&polygon_kml=0&polygon_svg=0&polygon_text=0&polygon_threshold=0.0&debug=0 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:29:20.840939 | 200 | 157ms | |
| 2026-03-23 10:25:22.053138 | 200 | 333ms | |
| 2026-03-23 10:18:07.508173 | 200 | 230ms | |
| 2026-03-23 09:42:21.909332 | 200 | 174ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:18:07.508173 | d678749b5b46 |
560561baf148 |
| 2026-03-23 10:25:22.053138 | 560561baf148 |
2199258709d7 |
| 2026-03-23 10:29:20.840939 | 2199258709d7 |
a82cc54da634 |