Skip to main content
GET
/
playback
/
{id}
TypeScript
import { Livepeer } from "livepeer";

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

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

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

run();
package main

import(
	livepeergo "github.com/livepeer/livepeer-go"
	"context"
	"log"
)

func main() {
    s := livepeergo.New(
        livepeergo.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    ctx := context.Background()
    res, err := s.Playback.Get(ctx, "<id>")
    if err != nil {
        log.Fatal(err)
    }
    if res.PlaybackInfo != nil {
        // handle response
    }
}
from livepeer import Livepeer

s = Livepeer(
    api_key="<YOUR_BEARER_TOKEN_HERE>",
)

res = s.playback.get(id="<id>")

if res.playback_info is not None:
    # handle response
    pass
curl --request GET \
  --url https://livepeer.studio/api/playback/{id} \
  --header 'Authorization: Bearer <token>'
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://livepeer.studio/api/playback/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://livepeer.studio/api/playback/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
HttpResponse<String> response = Unirest.get("https://livepeer.studio/api/playback/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://livepeer.studio/api/playback/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "type": "vod",
  "meta": {
    "source": [
      {
        "hrn": "MP4",
        "type": "html5/video/mp4",
        "url": "https://asset-cdn.lp-playback.monster/hls/1bde4o2i6xycudoy/static360p0.mp4",
        "size": 494778,
        "width": 204,
        "height": 360,
        "bitrate": 449890
      }
    ],
    "live": 0,
    "playbackPolicy": {
      "type": "webhook",
      "webhookId": "1bde4o2i6xycudoy",
      "webhookContext": {
        "streamerId": "my-custom-id"
      },
      "refreshInterval": 600,
      "allowedOrigins": [
        "<string>"
      ]
    },
    "dvrPlayback": [
      {
        "hrn": "MP4",
        "type": "html5/video/mp4",
        "url": "https://asset-cdn.lp-playback.monster/hls/1bde4o2i6xycudoy/static360p0.mp4",
        "error": "<string>"
      }
    ],
    "attestation": {
      "primaryType": "VideoAttestation",
      "domain": {
        "name": "Verifiable Video",
        "version": "1"
      },
      "message": {
        "video": "5b9e63bb-6fd0-4bea-aff2-cc5d4eb9cad0",
        "attestations": [
          {
            "role": "creator",
            "address": 1311768467294899700
          }
        ],
        "signer": 1311768467294899700,
        "timestamp": 1587667174725
      },
      "signature": 1311768467294899700,
      "id": "5b9e63bb-6fd0-4bea-aff2-cc5d4eb9cad0",
      "createdAt": 1587667174725,
      "signatureType": "eip712",
      "storage": {
        "ipfs": {
          "updatedAt": 1587667174725
        },
        "status": {
          "phase": "ready",
          "tasks": {
            "pending": "09F8B46C-61A0-4254-9875-F71F4C605BC7",
            "last": "09F8B46C-61A0-4254-9875-F71F4C605BC7",
            "failed": "09F8B46C-61A0-4254-9875-F71F4C605BC7"
          },
          "progress": 0.5,
          "errorMessage": "Failed to update storage"
        }
      }
    }
  }
}
{
  "errors": [
    [
      "id not provided",
      "Account not found"
    ]
  ]
}
{
  "errors": [
    [
      "id not provided",
      "Account not found"
    ]
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

The playback ID from the asset or livestream, e.g. eaw4nk06ts2d0mzb.

Response

Successful response

type
enum<string>
required
Available options:
live,
vod,
recording
Example:

"vod"

meta
object
required
Last modified on March 18, 2026