---
title: Fetch livestream session details using a session ID
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Realtime Kit](https://developers.cloudflare.com/api/resources/realtime_kit)
[Livestreams](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Fetch livestream session details using a session ID
GET/accounts/{account\_id}/realtime/kit/{app\_id}/sessions/{session\_id}/livestream-sessions
Returns livestream session details for the given session ID. Retreive the session ID using the `Fetch all sessions of an App` API.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Realtime Admin``Realtime`
##### P ath ParametersExpand Collapse
account\_id: string
The account identifier tag.
maxLength32
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_livestream_sessions_for_session%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
app\_id: string
The app identifier tag.
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_livestream_sessions_for_session%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>)
session\_id: string
formatuuid
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_livestream_sessions_for_session%20%3E%20(params)%20default%20%3E%20(param)%20session_id%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
page\_no: optional number
The page number from which you want your page search results to be displayed.
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_livestream_sessions_for_session%20%3E%20(params)%20default%20%3E%20(param)%20page_no%20%3E%20(schema)>)
per\_page: optional number
Number of results per page.
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_livestream_sessions_for_session%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
##### ReturnsExpand Collapse
data: object {data, paging }
data: array of object {id, created\_at, err\_message, 7 more }
id: string
ID of the livestream session.
formatuuid
Link to this property
created\_at: string
Timestamp the livestream session was created at, in ISO format.
formatdate-time
Link to this property
err\_message: string
Error message, if the livestream session failed.
Link to this property
ingest\_seconds: number
The time duration for which the input was given or the meeting was streamed.
Link to this property
invoked\_time: string
Timestamp the livestream session was invoked at, in ISO format.
formatdate-time
Link to this property
livestream\_id: string
ID of the livestream.
formatuuid
Link to this property
started\_time: string
Timestamp the livestream session started at, in ISO format.
formatdate-time
Link to this property
stopped\_time: string
Timestamp the livestream session stopped at, in ISO format.
formatdate-time
Link to this property
updated\_at: string
Timestamp the livestream session was last updated at, in ISO format.
formatdate-time
Link to this property
viewer\_seconds: number
The total view time for which the viewers watched the stream.
Link to this property
Link to this property
paging: object {end\_offset, start\_offset, total\_count }
end\_offset: number
Link to this property
start\_offset: number
Link to this property
total\_count: number
minimum0
Link to this property
Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_livestream_sessions_for_session_response%20%3E%20(schema)%20%3E%20(property)%20data>)
success: boolean
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_livestream_sessions_for_session_response%20%3E%20(schema)%20%3E%20(property)%20success>)
### Fetch livestream session details using a session ID
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/sessions/$SESSION_ID/livestream-sessions \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"data": {
"data": [
{
"created_at": "2023-07-15T07:08:40.742Z",
"err_message": null,
"id": "cf55a850-c3fd-46b5-b5d2-25b3b9aa1686",
"ingest_seconds": 600,
"invoked_time": "2023-07-15T07:08:26.634Z",
"livestream_id": "b60ef3da-fbbb-441b-9168-8235b0035248",
"started_time": "2023-07-15T07:08:39Z",
"stopped_time": "2023-07-15T07:18:39Z",
"updated_at": "2023-07-15T07:18:40.742Z",
"viewer_seconds": 1200
}
],
"paging": {
"end_offset": 1,
"start_offset": 1,
"total_count": 1
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"data": {
"data": [
{
"created_at": "2023-07-15T07:08:40.742Z",
"err_message": null,
"id": "cf55a850-c3fd-46b5-b5d2-25b3b9aa1686",
"ingest_seconds": 600,
"invoked_time": "2023-07-15T07:08:26.634Z",
"livestream_id": "b60ef3da-fbbb-441b-9168-8235b0035248",
"started_time": "2023-07-15T07:08:39Z",
"stopped_time": "2023-07-15T07:18:39Z",
"updated_at": "2023-07-15T07:18:40.742Z",
"viewer_seconds": 1200
}
],
"paging": {
"end_offset": 1,
"start_offset": 1,
"total_count": 1
}
},
"success": true
}
```