List User Followers

Returns the list of followers of a specific user.

Returns the list of followers for a specific user

GETyourpodURL.symphony.com/pod/v1/user/{uid}/followers

Path parameters

uid*integer (int64)

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

Query parameters

Header parameters

Response

200400401403500

Success

Body

application/json

countinteger (int64)

Example: 2

followersarray of integer (int64)

paginationPagination (object)

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/user/{uid}/followers', {
    method: 'GET',
    headers: {
      "sessionToken": "text"
    },
});
const data = await response.json();

Response

200400401403500

{
  "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