GET
Admin landlords list

Overview

Lists the curated landlords reference list used by the onboarding landlord autocomplete. Unlike the onboarding endpoint, this admin view includes inactive rows and supports pagination. Available to any admin role — read-only. The list is first populated by the pnpm seed:landlords script (a vendored data file mirroring the Regulator of Social Housing register — ~1,580 councils + private registered providers) and then curated here.

Authentication

Bearer <accessToken> with scope: 'admin' required (requireAdmin).
Read-only — all admin roles (SUPER, MODERATOR, FINANCE) may list. Create and update are role-gated to SUPER and MODERATOR.

Query parameters

Response — 200 OK

Landlord row

Error responses

See also

curl