GET
Tenancy verification detail

Overview

Everything a moderator needs to review one tenancy verification on a single page: the verification row (with a fresh 15-minute signed download URL for the private document), the applicant’s profile (including the decrypted dateOfBirth), their current-home listing (photos, description, features, rent, coordinates), and their desired-home preferences. GeoJSON [lng, lat] pairs are flattened to { lat, lng } server-side so clients can never swap them. Available to any admin role — the detail is read-only. The decisions (approve / reject) are role-gated.

Authentication

Bearer <accessToken> with scope: 'admin' required (requireAdmin).
Read-only — all admin roles (SUPER, MODERATOR, FINANCE) may view the detail. No audit row is written (parity with the queue listing).

Path parameters

Query parameters

None.

Request body

None.

Response — 200 OK

Four sections. applicant, currentHome, and preferences are independently nullable — a deleted account nulls applicant; a mid-onboarding user nulls currentHome/preferences.

applicant

currentHome

preferences

verification.documentDownloadUrl expires 15 minutes after the response is generated. If the moderator keeps the page open longer, re-fetch the detail to mint a new one.

Error responses

See also

curl

Postman

See docs/postman/swappr.postman_collection.json → Admin Tenancy → Detail.