---
title: "AutoSuggest with Coordinates"
method: GET
path: "/autosuggest-with-coordinates"
tags: ["what3words API"]
---

# AutoSuggest with Coordinates

`GET /autosuggest-with-coordinates`

## Request

- Base URL: `https://api.what3words.com/v3`
- URL: `https://api.what3words.com/v3/autosuggest-with-coordinates`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `X-Api-Key`

Similar to the AutoSuggest endpoint, but returns coordinates in the response. This endpoint requires special permissions.

## Query parameters

- `key` string
- `input` string, required
- `focus` string
- `n-focus-results` string
- `clip-to-country` string
- `clip-to-circle` string
- `clip-to-bounding-box` string
- `clip-to-polygon` string
- `language` string
- `locale` string
- `input-type` 'text' | 'vocon-hybrid' | 'nmdp-asr' | 'generic-voice' | 'speechmatics' | 'vin-big-data'
- `n-results` integer
- `prefer-land` boolean
- `format` 'json' | 'geojson'

## Response `200`

Successful autosuggest results

- AutosuggestWithCoordinatesResponse
  - `suggestions` AutosuggestWithCoordinatesSuggestion[]: List of suggested what3words addresses including coordinates
    - `words` string: The suggested what3words address
    - `country` string: The country in which the what3words address is located, as an ISO 3166-1 alpha-2 country code
    - `square` Square
      - `southwest` Coordinates
        - `lat` number, double: Latitude
        - `lng` number, double: Longitude
      - `northeast` Coordinates
        - `lat` number, double: Latitude
        - `lng` number, double: Longitude
    - `nearestPlace` string: The nearest place to the what3words address
    - `coordinates` Coordinates
      - `lat` number, double: Latitude
      - `lng` number, double: Longitude
    - `language` string: The language of the what3words address
    - `locale` string: The locale of the what3words address, if returned
    - `rank` integer: The relative ranking of this suggestion
    - `distanceToFocusKm` number, double: The distance in kilometers from the focus point to this suggestion's coordinates
    - `map` string: URL to view the what3words address on the what3words map

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid API key

## Changes

- **2026-03-04** `89db2437e8b6`: 11 warning, 7 info
  - deleted the `query` request parameter `locale`
  - added the new `BadInput` enum value to the `error/code` response property for the response status `400`
  - added the new `BadInput` enum value to the `error/code` response property for the response status `401`
  - added the new `BadNFocusResults` enum value to the `error/code` response property for the response status `400`
  - …14 more
- **2025-05-29** `b7027c5acae5`: 1 warning, 2 info
  - deleted the `query` request parameter `locale`
  - added the new optional `query` request parameter `locale`
  - added the new optional `query` request parameter `n-focus-results`

[Operation history](https://skmtc.dev/what3words/apis/what3words-api/changes/autosuggest-with-coordinates/get.md)

---

[API](https://skmtc.dev/what3words/apis/what3words-api.md) - [All operations](https://skmtc.dev/what3words/apis/what3words-api/llms.txt) - [OpenAPI document](https://skmtc.dev/what3words/apis/what3words-api/revisions/2f8f54251ad7?raw)