Developers
V1SocialProfilesIdConnections

Browse approved accepted followers or following with directory consent

Owners can browse their own accepted connections even while their profile awaits review. Other viewers need the target's consent and count access; each peer must also consent or be the viewer. Inaccessible, unreviewed, deleted, blocked and muted profiles are omitted before pagination. Cursors use social profile IDs only.

GET
/v1/social/profiles/{id}/connections
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

cursor?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
limit?integer
Range1 <= value <= 50
Default20
direction*string

Value in

  • "followers"
  • "following"

Response Body

application/json

curl -X GET "https://example.com/v1/social/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08/connections?direction=followers"
{  "profiles": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "alias": "string",      "handle": "string",      "visibility": "private",      "followerCount": 0,      "followingCount": 0,      "following": "none",      "followedBy": true,      "muted": true,      "canViewConnections": false    }  ],  "nextCursor": "53a4a333-2825-45a4-80d2-5f430d088f36"}