---
title: "Destination Autocomplete"
method: GET
path: "/places/destination-autocomplete"
tags: ["places"]
---

# Destination Autocomplete

`GET /places/destination-autocomplete`

Destination autocomplete for the onboarding "Where to?" screen.

Returns strings like "Paris, France", "Hawaii, United States",
"Maui County, HI, USA", or "Japan". Includes cities, states/provinces,
counties/regions, and countries so users planning a trip around a broader
area (e.g. an island or state) can pick that directly instead of being
forced to name a single city.

`predictions` carries the same rows with their place id and Google types
attached. The display string cannot distinguish "New York" the city from
"New York State"; the place id can, and the deck resolves a 49 km box for
one and a 505 km box for the other.

## Query parameters

- `query` string, required

## Response `200`

Successful Response

- DestinationAutocompleteResponse — Every prediction twice, in two shapes, on purpose. `suggestions` is the display line and nothing else, and it is what 1.0.14 renders — it ships today and puts these straight into a `<Text>`, so turning it into a list of objects would crash the screen it is meant to fix. `predictions` is the same list with the identity and the type Google already told us, for clients that can carry a place id through to the deck. Same order, same length, index for index.
  - `suggestions` string[], required
  - `predictions` StructuredSuggestion[], required
    - `place_id` string, required
    - `main_text` string, required
    - `secondary_text` string, nullable
    - `types` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)