Skip to content

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.

ref
required
integer format: int64

The account whose followers to list.

limit
integer
default: 50 >= 1 <= 200

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.

People who follow the account, most recent first, at most limit of them.

object
users
required

Up to limit people, most recent follow first; empty when there are none.

Array<object>

A person in a followers or following list.

object
ref
required

The person’s account ref.

integer format: int64
username
required

The person’s username; an empty string if they have none.

string
display_name

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.

string
nullable
avatar_url

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.

string
nullable
since

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.

string format: date-time

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed