lookup: Lookup places by OSM object IDs

API: openstreetmap.org:nominatim-api
Endpoint: /lookup
Response format: text/xml +1 format
Charset: utf-8
Auth: unknown
Method: GET
Last Status: 200
Latency: 238ms

Description

Retrieve address details for OpenStreetMap objects by their OSM ID. Supports up to 50 IDs per request.

Parameters (10)

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]}

email (string, query, optional)

Valid email for identification

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

Include tagged entrances (0 or 1)

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

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

Include extra data like Wikipedia, hours (0 or 1)

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

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

Output format

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

json_callback (string, query, optional)

Function name for JSONP wrapper

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

Include full name variants (0 or 1)

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

osm_ids (string, query, required)

Comma-separated list of OSM IDs, each prefixed with type: N (node), W (way), or R (relation). Max 50 IDs. Example: N123,W456,R789

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

Include full geometry as GeoJSON (0 or 1)

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

Examples (5)

OSM Object Lookup openapi-spec
curl 'https://nominatim.openstreetmap.org/lookup?osm_ids=R175342%2CW12345'
import requests

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

api = zingu_apis.api("nominatim")
result = api.fetch("lookup", osm_ids="R175342,W12345")

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?osm_ids=R175342%2CW12345");
const data = await resp.json();
OSM Object Lookup probe-gate
curl 'https://nominatim.openstreetmap.org/lookup?osm_ids=R175342%2CW12345&format=json&addressdetails=0&extratags=0&namedetails=0'
import requests

resp = requests.get(
    "https://nominatim.openstreetmap.org/lookup",
    params={
        'osm_ids': 'R175342,W12345',
        'format': 'json',
        'addressdetails': '0',
        'extratags': '0',
        'namedetails': '0',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nominatim")
result = api.fetch("lookup", osm_ids="R175342,W12345", format="json", addressdetails=0, extratags=0, namedetails=0)

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?osm_ids=R175342%2CW12345&format=json&addressdetails=0&extratags=0&namedetails=0");
const data = await resp.json();
Address Lookup by OSM IDs openapi-spec
curl 'https://nominatim.openstreetmap.org/lookup?osm_ids=N240109189%2CW12345678'
import requests

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

api = zingu_apis.api("nominatim")
result = api.fetch("lookup", osm_ids="N240109189,W12345678")

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?osm_ids=N240109189%2CW12345678");
const data = await resp.json();
Address Lookup by OSM IDs probe-gate
curl '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'
import requests

resp = requests.get(
    "https://nominatim.openstreetmap.org/lookup",
    params={
        'osm_ids': 'N240109189,W12345678',
        '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',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nominatim")
result = api.fetch("lookup", osm_ids="N240109189,W12345678", 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)

for item in result:
    print(item)
const resp = await fetch("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");
const data = await resp.json();
Lookup places by OSM object IDs probe-gate
curl 'https://nominatim.openstreetmap.org/lookup?format=jsonv2&addressdetails=1&extratags=0&namedetails=0&entrances=0&polygon_geojson=0'
import requests

resp = requests.get(
    "https://nominatim.openstreetmap.org/lookup",
    params={
        'format': 'jsonv2',
        'addressdetails': '1',
        'extratags': '0',
        'namedetails': '0',
        'entrances': '0',
        'polygon_geojson': '0',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("nominatim")
result = api.fetch("lookup", format="jsonv2", addressdetails=1, extratags=0, namedetails=0, entrances=0, polygon_geojson=0)

for item in result:
    print(item)
const resp = await fetch("https://nominatim.openstreetmap.org/lookup?format=jsonv2&addressdetails=1&extratags=0&namedetails=0&entrances=0&polygon_geojson=0");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:43:03.174024 200 238ms
2026-04-16 17:30:37.444432 200 202ms
2026-04-16 16:51:06.178499 200 272ms
2026-04-16 03:40:36.759180 200 230ms
2026-04-16 03:31:54.145468 200 227ms
2026-04-16 02:39:58.059339 200 774ms
2026-04-16 01:00:42.449386 200 172ms
2026-04-16 00:10:42.494513 200 358ms
2026-04-15 02:49:03.335729 200 199ms
2026-04-15 02:35:29.812239 200 262ms
2026-04-15 01:33:55.223682 200 237ms
2026-04-15 01:03:30.743366 200 196ms
2026-04-15 00:37:29.134995 200 383ms
2026-04-14 03:20:18.930466 200 194ms
2026-04-14 02:07:28.631674 200 198ms
2026-04-14 01:43:26.095627 200 232ms
2026-04-14 01:05:23.582581 200 301ms
2026-04-14 00:04:54.048816 200 212ms
2026-04-12 16:16:20.640028 200 203ms
2026-04-12 15:21:23.193639 200 261ms
2026-04-12 14:50:01.903539 200 648ms
2026-04-12 13:23:53.228117 200 190ms
2026-04-12 13:16:48.246107 200 308ms
2026-04-10 03:16:55.927454 200 2663ms
2026-04-10 01:58:18.834945 200 197ms
2026-04-10 01:35:17.757843 200 107ms
2026-04-10 00:37:35.360366 200 554ms
2026-04-10 00:29:41.477408 200 178ms
2026-04-09 02:33:04.319711 200 267ms
2026-04-09 01:06:48.139972 200 395ms
2026-04-09 00:23:59.174848 200 752ms
2026-04-09 00:10:41.128902 200 844ms
2026-04-09 00:06:35.506563 200 299ms
2026-04-03T10:40:24.074574 200 146ms
2026-03-30 03:03:07.797650 200 224ms
2026-03-30 02:56:51.393349 200 752ms
2026-03-30 02:18:23.900810 200 742ms
2026-03-30 02:05:57.757753 200 214ms
2026-03-29 13:28:45.466033 200 352ms
2026-03-29 13:11:06.901885 200 214ms
2026-03-29 13:03:33.269632 200 243ms
2026-03-29 12:51:14.353677 200 223ms
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