List User Followers

Returns the list of followers of a specific user.

Returns the list of followers for a specific user

get

Path parameters

uidinteger · int64Required

User ID as a decimal integer of the user we want to get the followers list

Query parameters

limitintegerOptional

This is the maximum number of objects that may be returned.

beforestringOptional

Returns results from an opaque “before” cursor value as presented via a response cursor.

afterstringOptional

Returns results from an opaque “after” cursor value as presented via a response cursor.

Header parameters

sessionTokenstringRequired

Session authentication token.

Responses

200

Success

application/json

400

Client error, see response body for further details.

application/json

401

Unauthorized: Invalid session token.

application/json

403

Forbidden: Caller lacks necessary entitlement.

application/json

500

Server error, see response body for further details.

application/json

get

/v1/user/{uid}/followers

HTTPcURLJavaScriptPython

GET /pod/v1/user/{uid}/followers HTTP/1.1
Host: yourpodURL.symphony.com
sessionToken: text
Accept: */*

{
  "count": 2,
  "followers": [
    13056700579848,
    13056700580889
  ],
  "pagination": {
    "cursors": {
      "before": "MTAxNTExOTQ1MjAwNzI5NDE=",
      "after": "NDMyNzQyODI3OTQw"
    },
    "previous": "https://tenantapi.d.isym.io/v1/tenantinfo?limit=25&before=MTAxNTExOTQ1MjAwNzI5NDE=",
    "next": "https://tenantapi.d.isym.io/v1/tenantinfo?limit=25&after=NDMyNzQyODI3OTQw"
  }
}

👍 Rules for pagination

• The count indicates the total number of items (e.g. the total number of followers)

• Considering that ranking indexing starts with 1, the cursor before indicates:

  • in the request: the rank of the last item wished in the payload (we want to show the maximum number of items positioned right before and including this one)

  • in the payload: the number of items that are present before the first item of the payload

• Considering that ranking indexing starts with 1, the cursor after indicates:

  • in the request: the rank of the first item wished from the payload + 1 (we want to show the maximum number of items positioned right after and excluding this one)

  • in the payload: the rank of the last item from the payload. When it is not present, it means that the last item in the payload is the last follower.

🚧 Notes & limitations

• No specific entitlement is required to call this endpoint, but it is not possible to have access to external users' information:

  • It is not possible to get the list of followers of an external user;

  • No external user is included in the list returned by the endpoint.

• If no limit parameter specified in the path of the request, it will be set by default to 100

📘 See also

• List Users Followed to list users who are followed by a specific user