Skip to main content
Get Followers
Returns a paginated list of users who follow the specified user. Authentication is optional — the endpoint works without a token. When the request has a viewer — the signed-in user, or the user a service key names in actingUserId — any user with a block between them and the viewer, in either direction, is excluded from the results. Block filtering requires the moderation bundle.
Requires the follows bundle. A project without the follows bundle returns 403 database/tables-not-available. See Bundles.

Path Parameters

string
required
The Sublay user ID (UUID) of the user whose followers to retrieve.

Query Parameters

Acting user

string
Service key only: the user to read as. The response is exactly what that user’s own access token would get — users block-edged with them are left out. Leave it out for the anonymous view. A user token always acts as its own user and must not send it, and neither may a request with no credentials (400 follow/acting-user-not-allowed).
number
Page number for pagination. Defaults to 1.
number
Number of results per page. Defaults to 20, maximum 100.
string
Optional search term. Filters the list to users whose username or name contains this text (case-insensitive). When omitted, no filtering is applied.
string
Restricts which field query matches against — username or name. When omitted, query matches either field.

Space-scoped reputation

This endpoint has no space in context, so the opt-in spaceReputation object accepts a spaceId of a space <uuid> or none only — context is rejected (400). It adds a spaceReputation field to each returned user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model.

Response

On success, returns HTTP 200 with a paginated response:
array
Array of follow entries.
object
Pagination metadata.

Error Responses

A user token, or a request with no credentials, sent actingUserId, even naming its own user. Only a service key names the user it acts as; a user token always acts as its own user.
Returned when a service key names an actingUserId that isn’t a user in this project.

See Also