Saltar al contenido principal
GET
/
session
/
{id}
TypeScript
import { Livepeer } from "livepeer";

const livepeer = new Livepeer({
  apiKey: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await livepeer.session.get("<id>");

  // Handle the result
  console.log(result);
}

run();
{
  "name": "test_session",
  "id": "de7818e7-610a-4057-8f6f-b785dc1e6f88",
  "kind": "stream",
  "userId": "66E2161C-7670-4D05-B71D-DA2D6979556F",
  "lastSeen": 1587667174725,
  "sourceSegments": 1,
  "transcodedSegments": 2,
  "sourceSegmentsDuration": 1,
  "transcodedSegmentsDuration": 2,
  "sourceBytes": 1,
  "transcodedBytes": 2,
  "ingestRate": 1,
  "outgoingRate": 2,
  "isHealthy": "<unknown>",
  "issues": "<unknown>",
  "createdAt": 1587667174725,
  "parentId": "de7818e7-610a-4057-8f6f-b785dc1e6f88",
  "projectId": "aac12556-4d65-4d34-9fb6-d1f0985eb0a9",
  "record": false,
  "recordingStatus": "waiting",
  "recordingUrl": "<string>",
  "mp4Url": "<string>",
  "playbackId": "eaw4nk06ts2d0mzb",
  "profiles": "<unknown>",
  "recordingSpec": "<unknown>"
}

​
Obtener sesión

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

​
id
string
requerido

ID of the session

Respuesta

Success

​
name
string
requerido
Ejemplo:

"test_session"

​
id
string
Ejemplo:

"de7818e7-610a-4057-8f6f-b785dc1e6f88"

​
kind
string
obsoleto
Ejemplo:

"stream"

​
userId
string
obsoleto
Ejemplo:

"66E2161C-7670-4D05-B71D-DA2D6979556F"

​
lastSeen
number
Ejemplo:

1587667174725

​
sourceSegments
number
Ejemplo:

1

​
transcodedSegments
number
Ejemplo:

2

​
sourceSegmentsDuration
number

Duration of all the source segments, sec

Ejemplo:

1

​
transcodedSegmentsDuration
number

Duration of all the transcoded segments, sec

Ejemplo:

2

​
sourceBytes
number
Ejemplo:

1

​
transcodedBytes
number
Ejemplo:

2

​
ingestRate
number

Rate at which sourceBytes increases (bytes/second)

Ejemplo:

1

​
outgoingRate
number

Rate at which transcodedBytes increases (bytes/second)

Ejemplo:

2

​
isHealthy
any
​
issues
any
​
createdAt
number

Timestamp (in milliseconds) at which stream object was created

Ejemplo:

1587667174725

​
parentId
string

Points to parent stream object

Ejemplo:

"de7818e7-610a-4057-8f6f-b785dc1e6f88"

​
projectId
string

The ID of the project

Ejemplo:

"aac12556-4d65-4d34-9fb6-d1f0985eb0a9"

​
record
boolean

Whether the stream should be recorded. Uses default settings. For more customization, create and configure an object store.

Ejemplo:

false

​
recordingStatus
enum<string>

The status of the recording process of this stream session.

Opciones disponibles:
waiting,
ready,
failed,
deleted,
none
​
recordingUrl
string

URL for accessing the recording of this stream session.

​
mp4Url
string

The URL for the stream session recording packaged in an MP4.

​
playbackId
string

The playback ID to use with the Playback Info endpoint to retrieve playback URLs.

Ejemplo:

"eaw4nk06ts2d0mzb"

​
profiles
any
​
recordingSpec
any
Last modified on March 1, 2026