GET
Tenancy verification queue

Overview

The moderation queue for tenancy verifications. Defaults to status=PENDING, ordered by createdAt DESC. Each row embeds a fresh, 15-minute signed download URL for the private tenancy document so a moderator can view the evidence without the file being publicly accessible. Rows of soft-deleted and banned accounts are left out of the list, total and counts. A banned applicant’s row returns if the account is unbanned. Available to any admin role — listing the queue 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 list the queue.

Path parameters

None.

Query parameters

Request body

None.

Response — 200 OK

Tenancy verification row

documentDownloadUrl expires 15 minutes after the response is generated. Surface it to the moderator immediately; if it expires, re-fetch the queue page to mint a new one.

Error responses

See also

curl

Postman

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