lookup: Lookup address details by OSM object ID

API: nominatim.org:nominatim-geocoding-api
Endpoint: /lookup
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 208ms

Description

Look up address details for OSM objects by their ID. Maximum 50 IDs per request.

Parameters (14)

accept-language (string, query, optional)

Preferred language for results

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

Include address breakdown (1=yes, 0=no)

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

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

Output debug info (returns HTML, 1=yes, 0=no)

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

email (string, query, optional)

Valid email for identification

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

Include entrances (1=yes, 0=no)

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

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

Include extra tags (1=yes, 0=no)

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

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

Output format

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

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

Include full name list (1=yes, 0=no)

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)

Add geometry in GeoJSON (1=yes, 0=no)

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

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

Add geometry in KML (1=yes, 0=no)

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

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

Add geometry in SVG (1=yes, 0=no)

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

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

Add geometry in WKT (1=yes, 0=no)

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

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

Geometry simplification tolerance in degrees

Examples (2)

Lookup address details by OSM object ID openapi-spec
curl 'https://nominatim.openstreetmap.org/lookup?osm_ids=W504484402%2CN2400852777'
import requests

resp = requests.get(
    "https://nominatim.openstreetmap.org/lookup",
    params={
        'osm_ids': 'W504484402,N2400852777',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nominatim-geocoding")
result = api.fetch("lookup", osm_ids="W504484402,N2400852777")

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?osm_ids=W504484402%2CN2400852777");
const data = await resp.json();
Lookup address details by OSM object ID probe-gate
curl 'https://nominatim.openstreetmap.org/lookup?osm_ids=W504484402%2CN2400852777&format=jsonv2&addressdetails=1&extratags=0&namedetails=0&entrances=0&polygon_geojson=0&polygon_kml=0&polygon_svg=0&polygon_text=0&polygon_threshold=0.0&debug=0'
import requests

resp = requests.get(
    "https://nominatim.openstreetmap.org/lookup",
    params={
        'osm_ids': 'W504484402,N2400852777',
        'format': 'jsonv2',
        'addressdetails': '1',
        'extratags': '0',
        'namedetails': '0',
        'entrances': '0',
        'polygon_geojson': '0',
        'polygon_kml': '0',
        'polygon_svg': '0',
        'polygon_text': '0',
        'polygon_threshold': '0.0',
        'debug': '0',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nominatim-geocoding")
result = api.fetch("lookup", osm_ids="W504484402,N2400852777", format="jsonv2", addressdetails=1, extratags=0, namedetails=0, entrances=0, polygon_geojson=0, polygon_kml=0, polygon_svg=0, polygon_text=0, polygon_threshold=0.0, debug=0)

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?osm_ids=W504484402%2CN2400852777&format=jsonv2&addressdetails=1&extratags=0&namedetails=0&entrances=0&polygon_geojson=0&polygon_kml=0&polygon_svg=0&polygon_text=0&polygon_threshold=0.0&debug=0");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 01:14:53.699325 200 208ms
2026-04-16 00:10:10.715621 200 186ms
2026-04-15 02:37:54.612636 200 179ms
2026-04-15 00:30:53.587396 200 203ms
2026-04-14 03:43:58.526077 200 200ms
2026-04-14 00:20:03.017040 200 385ms
2026-04-12 16:18:49.909250 200 274ms
2026-04-12 14:17:45.604958 200 200ms
2026-04-10 01:36:07.407449 200 259ms
2026-04-10 01:33:31.641291 200 203ms
2026-04-09 03:27:09.857833 200 258ms
2026-04-09 00:38:19.829825 200 277ms
2026-03-27T21:25:36.547870 200 182ms