---
title: "Lookup"
method: GET
path: "/lookup"
tags: ["Lookup"]
---

# Lookup

`GET /lookup`

The lookup API allows querying the address and other details of one or multiple OSM objects, such as nodes, ways, or relations.

## Query parameters

- `osm_ids` string, required
- `json_callback` string
- `addressdetails` 0 | 1
- `extratags` 0 | 1
- `namedetails` 0 | 1
- `accept-language` string
- `polygon_geojson` 0 | 1
- `polygon_kml` 0 | 1
- `polygon_svg` 0 | 1
- `polygon_text` 0 | 1
- `polygon_threshold` number
- `normalizeaddress` 0 | 1
- `normalizecity` 0 | 1
- `postaladdress` 0 | 1
- `statecode` 0 | 1
- `format` string

## Response `200`

OK

- Lookup
  - `place_id` integer — Unique identifier for the place.
  - `licence` string — License information for the data.
  - `osm_type` string — Type of OpenStreetMap object.
  - `osm_id` integer — Unique identifier for the OpenStreetMap object.
  - `boundingbox` string[] — List of bounding box coordinates [min_lat, max_lat, min_lon, max_lon].
  - `lat` string — Latitude of the location.
  - `lon` string — Longitude of the location.
  - `display_name` string — Formatted address for display.
  - `class` string — Categorization of map features based on their nature.
  - `type` string — It denotes the specific kind of feature within a class.
  - `address` Address — Breakdown of the address into elements. All these elements are optional and only those elements that are available for a given location will be returned.
    - `house_number` string — House number
    - `road` string — Road name
    - `neighbourhood` string — Neighbourhood
    - `hamlet` string — Hamlet
    - `suburb` string — Suburb
    - `village` string — Village name
    - `town` string — Town name
    - `city_district` string — Administrative area between city level and town level
    - `city` string — City name
    - `region` string — Region name
    - `county` string — County name
    - `state_district` string — District name
    - `state` string — State name
    - `state_code` string — State code
    - `postcode` string — Postal code
    - `country` string — Country name
    - `country_code` string — Country code
    - `name` string — Name of the entity/road in the given location
    - `water` string — The name of an ocean or sea, if the location falls within a body of water outside any country's administrative regions.
  - `extratags` Extratags — The dictionary with additional useful tags like website or maxspeed. Returned when `extratags=1` is set in the request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — The request has been made from an unauthorized domain.
- `404` — No location or places were found for the given input.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/locationiq/apis/locationiq-api-reference.md) · [All operations](https://skmtc.dev/locationiq/apis/locationiq-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/locationiq/locationiq-api-reference/revisions/62f2eab3d1ff/schema)