---
title: "Resolve Home Location"
method: POST
path: "/places/resolve-home-location"
tags: ["places"]
---

# Resolve Home Location

`POST /places/resolve-home-location`

Resolve a selected autocomplete place into a home-location draft:
coords + city/region/country + proposed home airports (curated metro
dict, Places fallback otherwise — docs/HOME_LOCATION_ONBOARDING.md §3).

The draft is a proposal; the client persists the user-confirmed value
through PUT /user, where it is validated as HomeLocation.

## Request body

- ResolveHomeLocationRequest
  - `place_id` string, required

## Response `200`

Successful Response

- HomeLocationDraft — A resolved-but-unconfirmed home location proposal: what the picker UI shows after the user selects an autocomplete suggestion. The client persists the user-confirmed subset as models.home_location.HomeLocation via PUT /user.
  - `place_id` string, required
  - `lat` number, required
  - `lng` number, required
  - `city` string, required
  - `region` string, nullable
  - `country` string, required
  - `country_code` string, nullable
  - `airports` ResolvedAirport[]
    - `iata` string, required
    - `name` string, required
    - `distance_km` number, required
    - `source` string, required

## 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)