GET
Get my current home

Overview

Returns the authenticated user’s current_homes document — the listing they created during onboarding step 2 (and which step 3 attached photos and a description to). Returns 404 NOT_FOUND if the user has not yet reached step 2, or if the listing has been soft-deleted (deletedAt != null). There is no public GET /current-home/{id} endpoint by design — listings are only visible through match context, which prevents scraping. This endpoint returns the caller’s own listing only.

Authentication

Bearer <accessToken> required. Scope: user.

Path parameters

None.

Query parameters

None.

Request body

None.

Response — 200 OK

Home object

Photo object

Example response

Error responses

Example error — 404

Side effects

None — this is a pure read.

See also

curl