List a user's followers
GET /users/{ref}/followers
Returns the people who follow the account ref, most recent follow
first.
Any signed-in account can list this for any account; no capability
is needed. Without a session cookie or bearer token that identifies
you, the answer is 401, whether or not public mode is on. A ref or
limit that isn’t a whole number gets a plain-text 400 before
sign-in is checked, and a ref with no account gets 404. Nothing
else limits the list: blocks between you and either account aren’t
checked, and accounts are listed whatever their status.
There is no paging. You get at most limit people, 50 unless you
ask for another number; a limit below 1 counts as 1 and one above
200 as 200. With no cursor and no total, a list of exactly limit
doesn’t tell you whether there are more, and a larger limit only
returns a longer list. With no followers, the list is empty. Follows
made at the same moment come by account ref, highest first.
Each person is shown with the name and picture stored on their
profile, without the fallbacks UserPublic applies, and since is
when they followed the account. Someone whose account has been
removed is left out. The list is read fresh each time. Server errors
get a plain-text 500.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The account whose followers to list.
Query Parameters
Section titled “Query Parameters ”How many followers to return, 50 if left out. Values below 1 count as 1 and above 200 as 200, and there’s no way to ask for the ones after them.
Responses
Section titled “ Responses ”People who follow the account, most recent first, at most limit of them.
object
Up to limit people, most recent follow first; empty when there are none.
A person in a followers or following list.
object
The person’s account ref.
The person’s username; an empty string if they have none.
The display name stored on their profile, with no fallback to the full name or username. Left out when unset, and an empty string when stored empty, as it is after a profile edit that left it blank.
The stored picture address from their profile; the server doesn’t fetch or check it. Left out when unset, and an empty string when it was cleared.
When the follow was made: on a followers list, when this person followed the account; on a following list, when the account followed this person. A follow made again after an unfollow has a new time.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Resource not found
object
Human-readable error summary
Example
the request could not be completed