# List Datafeed

The datafeed provides messages and events from all conversations that the user is in. The types of events surfaced in the datafeed can be found in the [Real Time Events](https://docs.developers.symphony.com/building-bots-on-symphony/datafeed/real-time-events) list. 

Returns the list of datafeeds for the user. Any datafeed ID of the list can then be used as input to the [Read Datafeed](https://rest-api.symphony.com/main/datafeed/read-datafeed-v5) endpoint.

## Returns the list of active datafeeds of the user.

> \_Available on Agent 2.57.0 and above.\_\
> \
> The datafeed provides messages and events from all conversations that the user\
> is in. The types of events surfaced in the datafeed can be found in the \[Real Time Events]\(./docs/real-time-events.md) list.\
> In most cases, only one active datafeed per user is required at a time.<br>

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v5/datafeeds":{"get":{"tags":["Datafeed"],"summary":"Returns the list of active datafeeds of the user.","description":"_Available on Agent 2.57.0 and above._\n\nThe datafeed provides messages and events from all conversations that the user\nis in. The types of events surfaced in the datafeed can be found in the [Real Time Events](./docs/real-time-events.md) list.\nIn most cases, only one active datafeed per user is required at a time.\n","operationId":"listDatafeed","parameters":[{"name":"sessionToken","in":"header","description":"Session authentication token.","required":true,"schema":{"type":"string"}},{"name":"keyManagerToken","in":"header","description":"Key Manager authentication token.","schema":{"type":"string"}},{"name":"tag","in":"query","description":"A unique identifier to ensure uniqueness of the datafeed. Used to restrict search.","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"description":"Datafeed sucessfully created.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/V5Datafeed"}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}}},"components":{"schemas":{"V5Datafeed":{"type":"object","properties":{"id":{"type":"string","description":"ID of the datafeed"},"createdAt":{"type":"integer","description":"[deprecated] Datafeed creation timestamp\n","format":"int64","deprecated":true},"type":{"type":"string","description":"The type of feed. Only allowed value is \"datahose\"."}},"description":"Container for the feed ID"},"V2Error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"object"}}}}}}
```