---
title: "Prefix-match a place name"
method: GET
path: "/places/autocomplete"
tags: ["discovery"]
---

# Prefix-match a place name

`GET /places/autocomplete`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/places/autocomplete`
- Auth: HTTP bearer

Prefix search over the place-name index, matching the final word of a partial query.

When to use: Provide place-name suggestions as a user types.

When not to use: Use lookupPlaces for address, business and brand suggestions, including partial names. Use searchPlaces for complete populated-place names.

## Query parameters

- `q` string, required
- `limit` integer
- `lat` number
- `lon` number

## Response `200`

Prefix-match a place name

- object
  - `schema` string
  - `query` string
  - `places` unknown[]
    - unknown
  - `meta` object
    - `requestId` string
    - `computeMs` integer
    - `requestedAt` string, date-time
    - `sources` object[]
      - `dataset` string
      - `observedAt` string, nullable
      - `license` string
    - `freshness` object, nullable
    - `licenses` string[]
    - `attribution` string[]

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)