---
title: "Home City Autocomplete"
method: GET
path: "/places/home-city-autocomplete"
tags: ["places"]
---

# Home City Autocomplete

`GET /places/home-city-autocomplete`

Home-city autocomplete for the onboarding / profile home-location picker.

Unauthenticated like destination-autocomplete (the onboarding step runs
pre-auth). Localities only — a home must be a city, not a country or
state — and structured (place_id + texts) so the selection can be
resolved to coords, components, and proposed airports via
POST /places/resolve-home-location.

## Query parameters

- `query` string, required

## Response `200`

Successful Response

- HomeCityAutocompleteResponse
  - `suggestions` 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.dev/stardrift/apis/fastapi/revisions/2297d4453a9c?raw)