List a user's followers

GET

/users/{id}/followers

Returns the users that follow the given user. Emails are never exposed.
A PRIVATE PROFILE ANSWERS AN EMPTY ARRAY to anyone but its owner (#1696). This list publishes other people's names, avatars, handles and counts, one row per follow, so a private profile's social graph is not enumerable through it. The COUNTS remain public — they ride on the profile payload, which carries real figures for a private profile. 200 with [], not 404: the person exists, their graph is closed.

Authorizations

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type

HTTP (bearer)

or

Parameters

Path Parameters

id*

Type

string

Required

Query Parameters

limit

Type

integer

Default

20

Maximum

100

offset

Type

integer

Default

0

Responses

Follower list

Content-Type

application/json

[

{

"id": "string",

"name": "string",

"avatar": "string",

"email": "string",

"role": "string",

"profile_slug": "string",

"follower_count": 0,

"campaign_count": 0,

"type": "string"

}

]

GET

/users/{id}/followers

Playground

Server

Authorization

BearerAuth

Variables

Key

Value

id*

limit

offset

Samples

Powered by VitePress OpenAPI