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 that belongs to the authenticated user. The library is resolved by the token's user_id — no path or query parameters are required.
AuthorizationRequires a valid API token in the
Authorizationheader (withoutBearerprefix).
HTTP Method & Path
GET /library
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Header | Value |
|---|---|
Authorization | Your Panda API token (no Bearer prefix) |
Response
Success Response (200)
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"user_id": "2481ef9b-5642-4fcd-b9aa-094e98b5cf0a",
"name": "pv-production-2481ef9b-5642-4fcd-b9aa-094e98b5cf0a",
"video_library_id": "609b5860-e7ba-4023-8a36-09e30f4ed1fb",
"pullzone_name": "vz-163a34ba-25b",
"pullzone_id": "4449600",
"api_key": "aws",
"video_library_pullzone_id": "4449601",
"parallel_upload_limit": 5,
"playback": ["720p", "480p", "360p", "240p", "1080p", "1440p", "2160p"],
"block_none_refer": false,
"encoding": ["1080p", "720p", "240p", "360p", "480p", "1440p", "2160p"],
"keep_original_files": false,
"compression_mode": "quality",
"hls_segment_duration": 10,
"drm": true
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Library ID — this is the library_id used by the other /library endpoints |
user_id | string (uuid) | Owner user ID |
name | string | Library name (auto-generated on signup) |
video_library_id | string (uuid) | Internal video library identifier |
pullzone_name | string | CDN pullzone name — this is the {library} segment of the player subdomain (player-{pullzone_name}.tv.pandavideo.com.br) |
pullzone_id | string | CDN pullzone ID |
api_key | string | Internal storage provider identifier (e.g. aws) |
video_library_pullzone_id | string | Video library pullzone ID |
parallel_upload_limit | integer | Max parallel uploads (default 5) |
playback | string[] | Resolutions exposed to the player. Expected to be a subset of encoding |
encoding | string[] | Resolutions the transcoding pipeline generates. Values: 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p |
block_none_refer | boolean | true when the CDN rejects playback requests without an allowed referrer |
keep_original_files | boolean | true when the uploaded master is preserved. Required to re-encode or encrypt a video later |
compression_mode | string | Encoder preset — size, balanced or quality |
hls_segment_duration | integer | Duration of each HLS segment, in seconds (4–15, default 6) |
drm | boolean | true when DRM is enabled for this library |
Important
- This response has no timestamps — there is no
created_at/updated_atfield.playbackandencodingare returned unordered; do not rely on the position of a resolution.keep_original_filesis a prerequisite for re-encoding and for encrypting videos that already exist. With it disabled, those operations fail.
Security settings are not returned hereThe library-wide security switches have their own endpoints and are not part of this response:
Setting Endpoint Download protection GET /block_download/Strict playback origin GET /panda_only_playback/HLS encryption of new uploads GET /library/{library_id}/hls-encryptionThe allowed-referrer list is not returned here either — use
GET /library/{library_id}?action=refer. Only theblock_none_referpolicy flag appears above.
Bootstrap on first accessIf
LibrarySettingsdoes not yet exist, it is created on-the-fly from the CDN'sEnabledResolutions(or a default of["360p","480p","720p","1080p"]when the CDN is unreachable). Cache keysgetLibraryById_{id}andgetVerifyIfHasLibraryId_USER_IDare invalidated.
Error Responses
| Status | When |
|---|---|
404 | Library with user id: USER_ID was not found — the token's user has no library |
500 | Internal error |
Example Usage
cURL
curl -H "Authorization: $PANDA_API_TOKEN" \
https://api-v2.pandavideo.com.br/libraryRelated
- Get a specific library by ID:
GET /library/{library_id}— see the page Get library details or referrers - Update qualities / settings:
PUT /library/{library_id}— see the page Videos Qualities - HLS segment duration: see Configure Hls Segments