GET /live_stream_key

Lists all stream keys belonging to the authenticated account. Each key contains the stream_key value and the rtmp URL needed to broadcast from an encoder (OBS, etc.), along with metadata about availability.

📘

Authorization

Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

⚠️

One live per stream key. To run two lives at the same time you need two stream keys. How many keys you can create comes from your plan, so the limit shows up when creating a key — POST /live_stream_key returns 400 the plan has no slot available to create stream key — not when creating a live.

📘

How many stream keys does an account have by default?

The number of stream keys available by default depends on the plan. For the Bronze and Silver plans, only 1 stream key is provided by default, while the Gold plan includes 2 stream keys by default. If you need more, additional keys can be purchased at an extra cost.

HTTP Method & Path

GET /live_stream_key

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Parameters

This endpoint takes no path, query, or body parameters.

Response

Success Response (200)

Returns an array of stream keys:

[
  {
    "id": "{stream_key_id}",
    "title": "Canal principal",
    "stream_key": "f58b18a0-9eea-4cf8-bcb6-b4b8d6cd9a80",
    "rtmp": "rtmp://vz-{hash}.us.pandavideo.live/live",
    "region": "us",
    "default": true,
    "is_attached": false,
    "created_at": "2026-09-07T02:30:00.000Z"
  },
  {
    "id": "{stream_key_id}",
    "title": "Canal reserva",
    "stream_key": "a1c94f60-2f77-49aa-9f0b-3d7c1b0e77aa",
    "rtmp": "rtmp://vz-{hash}.br.pandavideo.live/live",
    "region": "br",
    "default": false,
    "is_attached": true,
    "created_at": "2026-08-20T10:00:00.000Z"
  }
]

Response Schema (item)

📘

region is where you publish, not where your viewers are. It selects the server that receives the signal from your encoder. Picking the wrong one only makes your encoder publish further away; delivery to viewers does not depend on this field. It also affects the per-minute rate. A key created with a fixed region wins over the region sent when creating a live.

⚠️

Heads up: id is the stream_key_id you pass to Create live. The stream_key field is the secret value you give to the encoder — never share it client-side.

Creating a key

POST /live_stream_key accepts region (us or br, defaults to us) alongside title, and returns the created key:

{
  "id": "{stream_key_id}",
  "stream_key": "{stream_key}",
  "title": "Canal principal",
  "region": "br",
  "set_default": false,
  "subaccount_id": null,
  "created_at": "2026-09-07T02:30:00.000Z"
}

📘

The first key of the account is marked as the default automatically, even when you send set_default: false. Without region, the key is created as us.

// the plan has no room for another key
{ "errCode": "BadRequest", "errMsg": "the plan has no slot available to create stream key" }

Error Responses

• 401 Unauthorized — Missing or invalid API token.
• 500 Internal Server Error — Server-side error.

Example Usage

cURL — list the keys

curl -X GET "https://api-v2.pandavideo.com.br/live_stream_key" \
  -H "Authorization: {api_key}"

cURL — create a key in the br region

curl -X POST "https://api-v2.pandavideo.com.br/live_stream_key" \
  -H "Authorization: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Canal principal", "region": "br", "set_default": false }'

Related

• Create Live Stream Key — create a new key.
• Update/Reset Live Stream Key — rename or rotate the secret of an existing key.
• Delete Live Stream Key — remove a key.