---
title: "Resolve Place"
method: GET
path: "/places/{place}"
tags: ["Place Search"]
---

# Resolve Place

`GET /places/{place}`

## Request

- Base URL: `https://api.addresszen.com/v1`
- URL: `https://api.addresszen.com/v1/places/{place}`
- Auth: HTTP bearer

Returns the full place for a place ID taken from a `/places` suggestion.

On top of the fields carried by the suggestion, the response adds coordinates, language and the underlying dataset record.

Each request decrements your lookup balance. An unknown ID returns `404`.

## Path parameters

- `place` string, required

## Query parameters

- `api_key` string
- `tags` string

## Response `200`

Success

- ResolvePlaceResponse
  - `code` 2000, required
  - `message` 'Success', required
  - `result` Place, required: A geographical place: an administrative division, capital or seat of administration city drawn from GeoNames. `GET /places` returns a suggestion for each match and `GET /places/{place}` resolves a suggestion id to the full place. `native` holds the underlying GeoNames record.
    - `id` string, required: Global unique internally generated identifier for a place
    - `dataset` 'geonames', required: Indicates the provenance of a place.
    - `name` string, required: Place name
    - `descriptive_name` string, required: Longer form description of the place.
    - `country_iso` string, required: 3 letter country code (ISO 3166-1)
    - `language` 'en' | 'ar' | 'as' | 'az' | 'be' | 'bg' | 'bn' | 'bs' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'es' | 'et' | 'eu' | 'fi' | 'fo' | 'fr' | 'ga' | 'gl' | 'gn' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'kk' | 'km' | 'kn' | 'ko' | 'lt' | 'lv' | 'mk' | 'mn' | 'ms' | 'mt' | 'my' | 'nl' | 'no' | 'pl' | 'pt' | 'rm' | 'ro' | 'ru' | 'sk' | 'sl' | 'sq' | 'sr' | 'sv' | 'ta' | 'th' | 'tr' | 'uk' | 'uz' | 'vi' | 'wa' | 'zh', required: Language represented by 2 letter ISO Code (639-1)
    - `longitude` union, required: The longitude of the address or postcode (WGS84). Can be a positive or negative decimal. E.g. -0.1283983 Returns an empty string if no location data is available.
      - string: Empty string `""` if not available
      - number: Represents longitude
    - `latitude` union, required: The latitude of the address or postcode (WGS84). Can be a positive or negative decimal. E.g. `51.5083983`. Returns an empty string if no location data is available.
      - string: Empty string `""` if not available
      - number: Represents latitude
    - `native` GeonamesPlace, required: The GeoNames record backing a place, as indexed. Only administrative divisions (feature class `A`) and capital or seat-of-administration cities (feature codes `PPLC` and `PPLA*`) are indexed. Historical features (feature codes ending in `H`) are excluded.
      - `id` string, required: Unique place ID
      - `dataset` 'geonames', required: Indicates the provenance of a place
      - `geonameid` integer, required: Unique identifier for GeoNames place
      - `name` string, required: Place name (UTF8)
      - `asciiname` string, required: Place name (ASCII). Empty string if not available
      - `alternatenames` string[], required: List of alternate names for the place
      - `language` 'en' | 'ar' | 'as' | 'az' | 'be' | 'bg' | 'bn' | 'bs' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'es' | 'et' | 'eu' | 'fi' | 'fo' | 'fr' | 'ga' | 'gl' | 'gn' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'kk' | 'km' | 'kn' | 'ko' | 'lt' | 'lv' | 'mk' | 'mn' | 'ms' | 'mt' | 'my' | 'nl' | 'no' | 'pl' | 'pt' | 'rm' | 'ro' | 'ru' | 'sk' | 'sl' | 'sq' | 'sr' | 'sv' | 'ta' | 'th' | 'tr' | 'uk' | 'uz' | 'vi' | 'wa' | 'zh', required: Language represented by 2 letter ISO Code (639-1)
      - `latitude` union, required: The latitude of the address or postcode (WGS84). Can be a positive or negative decimal. E.g. `51.5083983`. Returns an empty string if no location data is available.
        - string: Empty string `""` if not available
        - number: Represents latitude
      - `longitude` union, required: The longitude of the address or postcode (WGS84). Can be a positive or negative decimal. E.g. -0.1283983 Returns an empty string if no location data is available.
        - string: Empty string `""` if not available
        - number: Represents longitude
      - `feature_class` 'A' | 'P', required: GeoNames single letter feature class (http://www.geonames.org/export/codes.html). Only two are indexed - `A` Country, state, region - `P` City, village
      - `feature_code` string, required: Full GeoNames feature code (http://www.geonames.org/export/codes.html)
      - `country_code` string, required: 2 letter ISO country code. Empty string if not available
      - `country_iso` string, required: 3 letter ISO country code derived from `country_code`. Empty string if the country cannot be resolved
      - `cc2` string[], required: List of other country codes mapping to this place
      - `admin1_name` string, required: Name of first administrative area. Empty string if not available
      - `admin1_geonameid` integer, nullable, required: GeoName ID for first administrative area
      - `admin1_code` string, required: Fipscode (subject to change to iso code)
      - `admin2_name` string, required: Name of second administrative area. Empty string if not available
      - `admin2_geonameid` integer, nullable, required: GeoName ID for second administrative area
      - `admin2_code` string, required: Code for the second administrative division
      - `admin3_code` string, required: Code for third level administrative division
      - `admin4_code` string, required: Code for fourth level administrative division
      - `population` string, required: Population at place. Represented as a string as it can be larger than a 32 bit integer
      - `elevation` integer, nullable, required: Elevation in metres. `null` if not available
      - `dem` integer, nullable, required: Digital elevation model (srtm3 or gtopo30), average elevation in metres
      - `timezone` string, required: The IANA timezone ID. Empty string if not available
      - `modification_date` string, date-time, required: Date the GeoNames record was last modified

## Other responses

- `404`: Resource not found
- `default`: Error

---

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