GET
Get match detail

Overview

Returns the full detail for a single match — everything the Property Detail screen needs: the other user’s listing (with description), their housing provider, what they’re looking for, and the per-filter match flags. The property, peer, housingProvider, and theyWant blocks are all relative to the other participant (never the caller). Returns 404 NOT_FOUND if the match does not exist or if the caller is not a participant — existence is never leaked.

Authentication

Bearer <accessToken> required. Scope: user. Requires completed onboarding + approved tenancy (requireOnboarded).

Path parameters

Query parameters

None.

Request body

None.

Response — 200 OK

Match detail object

All Match summary fields (matchId, score, perfectMatch, matchTier, savedAt, peer, property) plus:

theyWant object

Example response

Error responses

Example error — 404

Side effects

None — this is a pure read.

See also

curl