get
https://api-v2.pandavideo.com.br/lives//info_host
Shows what the ingest server is receiving from the encoder right now (bytes, bandwidth, resolution, frame rate). Works only while the live is online; an empty ret means no reading yet.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
GET /lives/{live_id}/info_host
{live_id}/info_hostReports what the ingest server is receiving from your encoder right now: inbound bytes, bandwidth, resolution and frame rate. This is the endpoint that answers "I am broadcasting and nothing shows up" — if it returns a reading, the signal is arriving.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
Only works while the live isonline. In any other status the call returns400 Live with id: {live_id} needs to be online to get info.
An emptyretis not an error. Right after the live goes online there may be no measurement yet, and the endpoint answers200with{ "ret": {} }. "No reading" and "no signal" are different things — poll again before concluding the encoder is down.
HTTP Method & Path
GET /lives/{live_id}/info_host
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
live_id | string (uuid) | Yes | ID of the live. Must be a valid uuid, otherwise the call returns 400. |
This endpoint takes no query or body parameters.
Response
Success Response (200)
{
"ret": {
"bytes_in": 184320000,
"bw_in": 2450000,
"time": 1757254800,
"meta": {
"video": { "width": 1280, "height": 720, "frame_rate": 30, "codec": "H264" },
"audio": { "codec": "AAC", "channels": 2, "sample_rate": 48000 }
}
}
}| Field | Type | Description |
|---|---|---|
ret | object | The reading. Empty object when no measurement has arrived yet. |
ret.bytes_in | number | Bytes received from the encoder. |
ret.bw_in | number | Inbound bandwidth of the signal. Falls back to bytes_in when not reported separately. |
ret.time | number | Timestamp of the reading. |
ret.meta.video.width | number | Width of the incoming video, in pixels. |
ret.meta.video.height | number | Height of the incoming video — this is what tells you the resolution actually arriving. |
ret.meta.video.frame_rate | number | Frame rate being received. |
ret.meta.video.codec | string | Video codec. |
ret.meta.audio | object | Audio description: codec, channels, sample_rate. |
Only the video numbers are measured. On the current ingest path, width, height and frame rate come from the live reading, whilecodecand the wholemeta.audioblock are reported as fixed values (H264,AAC, 2 channels, 48000 Hz). Do not use the audio block to diagnose an audio problem.
Reading it against the quality you configured.meta.video.heightis what the ingest is actually receiving from your encoder. Remember that the delivered ladder is capped at 720p regardless of what you publish — see Create live.
Error Responses
- 400 Bad Request —
{ "errCode": "BadRequest", "errMsg": "Live with id: {live_id} needs to be online to get info" }, orinvalid live id: "{value}"when the path parameter is not a uuid. - 404 Not Found —
{ "errCode": "NotFound", "errMsg": "Live with id: {live_id} was not found" }. - 200 with an empty body — when the ingest reading itself fails, the endpoint still answers
200, with{}and noretkey at all. Guard for a missingret, not only for an empty one.
Example Usage
cURL
curl -X GET "https://api-v2.pandavideo.com.br/lives/{live_id}/info_host" \
-H "Authorization: {api_key}"Related
- Start live — bring a scheduled live forward before checking the signal.
- Get Stream Metrics for Live Stream — historical series instead of the current reading.
- Get Buffering Metrics for Live Stream — playback side, not ingest.