# 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](https://rest-api.symphony.com/main/streams-conversations/all-streams-endpoints/stream-members) 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](https://rest-api.symphony.com/main/groups-distribution-lists) for more information.