---
title: "Find Place"
method: GET
path: "/places"
tags: ["Place Search"]
---

# Find Place

`GET /places`

## Request

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

Returns place suggestions for a query, ranked by relevance. Places cover countries, administrative areas, capitals and other administrative seats.

## Implementing Place Autocomplete

Retrieving a full place takes two requests:

1. Fetch suggestions from `/places`
2. Fetch the place using the `id` on a suggestion

A query returns at most 10 suggestions. An empty query returns an empty result set. Show users the `descriptive_name`. The API drops suggestions that share one, so each name in a response identifies a single place.

## Rate Limiting and Cost

The rate limit is 3,000 requests per 5 minutes.

`/places` does not decrement your lookup balance, but resolving a suggestion to a full place does. We rate limit and then suspend integrations that repeatedly call `/places` without resolving.

## Query parameters

- `api_key` string
- `query` string
- `country_iso` string
- `bias_country_iso` string
- `bias_lonlat` string
- `bias_ip` 'true'

## Response `200`

Success

- PlaceResponse
  - `code` 2000, required
  - `message` 'Success', required
  - `result` object, required
    - `hits` PlaceSuggestion[], required: List of up to 10 matching places
      - `id` string, required: Unique identifier for 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)

## Other responses

- `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)