GET /library/{library_id}

A single path that behaves in two distinct ways depending on whether the ?action=refer query parameter is present.

Operations Available

🚧

?action=refer is required to list referrers. Without it, the gateway returns the library details object — not the referrer list.

📘

Authorization

Requires a valid API token in the Authorization header (without Bearer prefix). The library_id must belong to the authenticated user.

HTTP Method & Path

GET /library/{library_id}

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

Authentication Requirements

Path Parameters

Query Parameters

Response

Mode 1 — No action: Library details (200)

Same shape as GET /library. See the response schema on that page.

Mode 2 — ?action=refer: Referrer list (200)

{
  "refers": [
    {
      "id": "789e4567-e89b-12d3-a456-426614174999",
      "type": "ALLOW",
      "url": "example.com",
      "status": "active"
    },
    {
      "id": "abc12345-e89b-12d3-a456-426614174000",
      "type": "ALLOW",
      "url": "*.partner.com",
      "status": "pending"
    }
  ]
}

Response Schema (referrer list)

📘

Referrer states

• active / inactive — terminal states.
• pending / turning_inactive / deleting — transient (syncing with Bunny CDN via the refer worker).

Error Responses

Example Usage

cURL — library details

curl -H "Authorization: $PANDA_API_TOKEN" \
  https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000

cURL — list referrers

curl -H "Authorization: $PANDA_API_TOKEN" \
  "https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000?action=refer"

Related

• Get the library for the current user: GET /library
• Add referrers: POST /library/{library_id}?action=refer
• Remove referrers: DELETE /library/{library_id}?action=refer
• Toggle refer policy: POST /library/{library_id}?action=referValidation