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

# Find Place

`GET /places`

Query for geographical places across countries. Each query will return a list of place suggestions, which consists of a place name, descriptive name and id.

This API returns geographical information such as countries, capitals, administrative areas and more. It is ideal for correctly identifying a place along with any other details like geolocation.

## Implementing Place Autocomplete

Extracting the full information of a place is a 2 step process:

1. Retrieve place suggestions via /places
2. Retrieve the entire place with the ID provided in the suggestion

## Suggestion Format

Each place suggestion contains a descriptive name which you can provide to users to uniquely identify a place.

## Rate Limiting and Cost

The rate limit for the Autocomplete API is 3000 requests per 5 minutes. HTTP Headers inform about the current rate limit.

Autocomplete API usage does not impact your balance, but resolving a suggestion to a full address requires a paid request. Autocomplete requests without subsequent paid requests may result in rate limitation or suspension.

## 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
      - `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)
      - `id` string, required — Unique identifier for place

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/ideal-postcodes/apis/api-reference.md) · [All operations](https://skmtc.net/ideal-postcodes/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideal-postcodes/api-reference/revisions/295dd3238f22/schema)