# Stream Info

## GET /v2/streams/{sid}/info

> Get information about a partcular stream.

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v2/streams/{sid}/info":{"get":{"summary":"Get information about a partcular stream.","parameters":[{"schema":{"type":"string"},"name":"sid","description":"Stream Id","in":"path","required":true},{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true}],"tags":["Streams"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2StreamAttributes"}}}},"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":{"V2StreamAttributes":{"type":"object","properties":{"id":{"type":"string","description":"The stream ID."},"crossPod":{"type":"boolean","description":"If true, this is a cross-pod stream."},"origin":{"type":"string","description":"INTERNAL if the creator of this stream belongs to the pod, EXTERNAL otherwise"},"active":{"type":"boolean","description":"If true, this stream is active."},"lastMessageDate":{"type":"integer","format":"int64","description":"unix timestamp of the last message sent in the stream"},"streamType":{"description":"The type of the stream (IM = IM, multi-IM = MIM, chat room = ROOM, user wall = POST).","$ref":"#/components/schemas/V2StreamType"},"streamAttributes":{"$ref":"#/components/schemas/V2ConversationSpecificStreamAttributes"},"roomAttributes":{"$ref":"#/components/schemas/V2RoomSpecificStreamAttributes"}}},"V2StreamType":{"type":"object","properties":{"type":{"type":"string"}}},"V2ConversationSpecificStreamAttributes":{"type":"object","properties":{"members":{"$ref":"#/components/schemas/UserIdList"}}},"UserIdList":{"type":"array","items":{"type":"integer","format":"int64"}},"V2RoomSpecificStreamAttributes":{"type":"object","properties":{"name":{"type":"string","description":"Room name."},"groups":{"description":"List of groups (aka SDLs) that were added to the room. Since SBE 20.14.","type":"array","items":{"$ref":"#/components/schemas/GroupItem"}}}},"GroupItem":{"type":"object","properties":{"id":{"description":"The ID of the added group (aka SDL).","type":"integer","format":"int64"},"addedBy":{"description":"The user ID who added the group to the room.","type":"integer","format":"int64"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

Note: visit [Overview](https://docs.developers.symphony.com/building-bots-on-symphony/datafeed/overview-of-streams) for an overview of streams.

In the response,

* The `crossPod` field indicates whether the stream is External or Internal.
* The `origin` field indicates the origin of the room: INTERNAL (created by a user of the calling user's company) or EXTERNAL (created by a user of another company). Only applies to chatrooms with External scope.
* The `active` field indicates whether the stream is active or inactive. An IM is inactive if at least one of the participants is a deactivated user. A room is inactive if it has been deactivated by an owner or an administrator.
* `lastMessageDate` states when the last message sent in that stream. The time is in epoch format.
* `streamType` can be `IM` (1-1 instant message), `MIM` (multi-party instant message, deprecated), `ROOM`, or `POST` (user profile wall posts).
* For IMs and walls, `streamAttributes` contains the `members` array with userIds of participants. In the case of wall posts, there is only one participant (the user whose wall it is).
* For rooms, `roomAttributes` contains the `name` of the room. To get the participants of the room, call the [Room Members](/main/streams-conversations/all-streams-endpoints/stream-members.md) endpoint.
* If the stream is IM or room with `discoverable`set as "false", the caller needs to have the VIEW\_ANY\_STREAM\_DETAILS privilege. Refer to [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.

> #### 📘 Note - Groups
>
> Since 20.14, please note that the object `groups` has been added in the roomAttributes object only if at least a Group has been added to the room. It is an array containing:
>
> * `id` attribute: ID of the Group,
> * `addedBy`: ID of the user who added the Group to the room
>
> See [Groups](/main/groups-distribution-lists.md) for more information.


---

# 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/streams-conversations/all-streams-endpoints/stream-info-v2.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.