---
title: "Lookup Nominatim OSM ids"
method: GET
path: "/geocoding/lookup"
tags: ["Geocoding"]
---

# Lookup Nominatim OSM ids

`GET /geocoding/lookup`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/geocoding/lookup`
- Auth: API key in header `x-api-key`

Looks up OpenStreetMap objects by the required `osm_ids`, a comma-separated list prefixed `N` (node), `W` (way) or `R` (relation), such as `W34633854,N123`. Each place has its display name, category and type, coordinates, bounding box, importance and address parts; `addressdetails` defaults to true, and `extratags`, `namedetails` and `accept_language` are optional. Malformed ids return `400`; no match returns `404`.

## Query parameters

- `osm_ids` string, required
- `accept_language` string
- `addressdetails` boolean
- `extratags` boolean
- `namedetails` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GeocodingLookupResponseDoc
  - `code` integer
  - `data` GeocodingLookupResponse
    - `query` string
    - `results` GeocodingPlace[]
      - `address` GeocodingAddress
        - `ISO3166-2-lvl4` string: ISO 3166-2 code for the state or region level, such as `US-NY`.
        - `ISO3166-2-lvl6` string: ISO 3166-2 code for the level-6 administrative area, when one exists.
        - `city` string: City of the place.
        - `country` string: Country name of the place.
        - `country_code` string: Two-letter country code of the place in lowercase, such as `us`.
        - `county` string: County of the place.
        - `house_number` string: House number of the place.
        - `neighbourhood` string: Neighbourhood of the place.
        - `office` string: Office name of the place, such as `Empire State Building`.
        - `postcode` string: Postal code of the place.
        - `road` string: Street name of the place.
        - `state` string: State or region of the place.
        - `state_district` string: State district of the place.
        - `suburb` string: Suburb or borough of the place.
        - `town` string: Town of the place.
        - `village` string: Village of the place.
      - `addresstype` string: Type of address the place represents, such as `office`.
      - `boundingbox` string[]: Bounding box of the place as four decimal-degree strings: south latitude, north latitude, west longitude, east longitude.
      - `category` string: OpenStreetMap category of the place, such as `office`.
      - `display_name` string: Full address of the place as a comma-separated string.
      - `extratags` object: Additional OpenStreetMap tags of the place. Present only when `extratags` is requested.
      - `importance` number: Importance score of the place; higher values mean a more prominent place.
      - `lat` string: Latitude of the place in decimal degrees, as a string.
      - `licence` string: Licence notice for the OpenStreetMap data.
      - `lon` string: Longitude of the place in decimal degrees, as a string.
      - `name` string: Name of the place.
      - `namedetails` object: Alternative names of the place. Present only when `namedetails` is requested.
      - `osm_id` integer: OpenStreetMap id of the object.
      - `osm_type` string: OpenStreetMap object type, such as `way`.
      - `place_id` integer: Numeric id of the place in the geocoding results.
      - `place_rank` integer: Address rank of the place; for example `30` for a building.
      - `type` string: OpenStreetMap type of the place within its `category`, such as `yes`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `502`: Bad Gateway
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)