Admin listings list
Listings
Admin listings list
List current-home listings for the admin gallery view, excluding soft-deleted rows. Cursor-paginated.
GET
Admin listings list
Overview
The admin gallery view of current-home listings. Soft-deleted rows are excluded. Ordered bycreatedAt DESC. Available to any admin role — read-only.
Authentication
Bearer <accessToken> with scope: 'admin' required (requireAdmin).
Read-only — all admin roles (SUPER, MODERATOR, FINANCE) may list. The delete action is role-gated.
Path parameters
None.Query parameters
| Name | Type | Required | Notes | Example |
|---|---|---|---|---|
status | enum | no | DRAFT, LIVE, or HIDDEN. Omit for all (non-deleted) statuses. | LIVE |
cursor | string | no | Opaque base64url pagination cursor, 1..512 chars. | eyJjcmVhdGVkQXQ… |
limit | integer | no | Page size, 1..100. Default 25. | 50 |
Request body
None.Response — 200 OK
| Field | Type | Notes |
|---|---|---|
items | array | Array of listing rows (below). |
nextCursor | string | null | Cursor for the next page, or null on the last page. |
Listing row
| Field | Type | Notes |
|---|---|---|
id | string | Listing ObjectId. |
userId | string | Owner. |
status | enum | DRAFT | LIVE | HIDDEN. |
propertyType | string | |
bedrooms | integer | |
bathrooms | integer | |
address | string | |
postcode | string | |
rentMonthlyMinor | integer | Rent in minor units (pence). |
photoCount | integer | Number of photos attached. |
coverPhotoUrl | string | null | Signed URL for the cover photo, or null. |
deletedAt | string | null | Always null here (soft-deleted rows are excluded from this list). |
createdAt | string | ISO timestamp. |
owner | object | null | { id, email, firstName, lastName }, or null. |
Error responses
| Status | Code | Meaning |
|---|---|---|
| 400 | VALIDATION_FAILED | limit out of 1..100 or status unknown. |
| 401 | UNAUTHENTICATED | Missing, malformed, expired, or non-admin-scope token. |
See also
- Delete listing — soft-delete a row.
curl
Postman
Seedocs/postman/swappr.postman_collection.json → Admin Listings → List.