Returns the library settings of the authenticated account — id (library_id), name, default encoding/playback qualities, referrer-protection flags, and allowed referers list.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /library
Returns the library settings of the authenticated account. The library holds account-level configuration that affects how videos are encoded and played back — including the default encoding and playback quality lists, referrer-protection settings, and other org-wide flags.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /library
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) |
This endpoint takes no path, query, or body parameters.
Response
Success Response (200)
Returns the library settings object:
{
"id": "ffffffff-1111-2222-3333-444444444444",
"name": "My library",
"encoding": ["240p", "360p", "480p", "720p", "1080p"],
"playback": ["360p", "720p", "1080p"],
"block_none_refer": false,
"allowed_referers": [],
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-05-29T14:00:00.000Z"
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Library ID — used as the library_id path parameter on other endpoints (e.g., Video Qualities). |
name | string | Display name of the library. |
encoding | array of strings | Resolutions that will be converted during encoding for new uploads. Values: 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p. |
playback | array of strings | Resolutions available for viewers during playback. Subset of encoding. |
block_none_refer | boolean | When true, blocks playback requests that arrive without a Referer header. |
allowed_referers | array | Domains allowed to embed/play videos (referer whitelist). |
created_at | string | ISO 8601 timestamp of creation. |
updated_at | string | ISO 8601 timestamp of last update. |
Use caseSave the
idreturned here to call Video Qualities and other library-scoped endpoints. The sameidis also exposed aslibrary_idon each video object.
Error Responses
- 401 Unauthorized — Missing or invalid API token.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/library' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'Recipes
The Recipes section provides a collection of code examples and sample implementations to help you understand and use the API effectively.