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

# Home City Autocomplete

`GET /places/home-city-autocomplete`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/places/home-city-autocomplete`
- Auth: none declared

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/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)