# List Users Followed

## GET /v1/user/{uid}/following

> Returns the list of users that a specific user is following

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v1/user/{uid}/following":{"get":{"summary":"Returns the list of users that a specific user is following","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true},{"schema":{"type":"integer","format":"int64"},"name":"uid","description":"User ID as a decimal integer of the user we want to get the following list","in":"path","required":true},{"schema":{"type":"integer"},"name":"limit","description":"This is the maximum number of objects that may be returned.","in":"query","required":false},{"schema":{"type":"string"},"name":"before","description":"Returns results from an opaque “before” cursor value as presented via a response cursor.","in":"query","required":false},{"schema":{"type":"string"},"name":"after","description":"Returns results from an opaque “after” cursor value as presented via a response cursor.","in":"query","required":false}],"tags":["User"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowingListResponse"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Invalid session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"FollowingListResponse":{"type":"object","properties":{"count":{"type":"integer","format":"int64"},"following":{"type":"array","items":{"type":"integer","format":"int64"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Pagination":{"type":"object","required":["cursors"],"properties":{"cursors":{"type":"object","required":["before"],"properties":{"before":{"type":"string","description":"This is the opaque url-safe string that points to the start of the page of data\nthat has been returned.\n"},"after":{"type":"string","description":"This is the opaque url-safe string that points to the end of the page of data\nthat has been returned.\n"}}},"previous":{"type":"string","description":"API endpoint that will return the previous page of data. If not included, this is\nthe first page of data.\n"},"next":{"type":"string","description":"API endpoint that will return the next page of data. If not included, this is the\nlast page of data. Due to how pagination works with visibility and privacy, it is\npossible that a page may be empty but contain a 'next' paging link. Stop paging when\nthe 'next' link no longer appears.\n"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 👍 Rules for pagination
>
> * The count indicates the total number of items (e.g. the total number of users followed)
> * 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 user followed.

> #### 🚧 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 users followed by 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 User Followers](/main/users/list-user-followers.md) to list the followers of a specific user


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rest-api.symphony.com/main/users/list-users-followed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.