GET /playlists/{playlist_id}

Returns a single playlist owned by the authenticated user. Includes the linked image record (logo) when set.

📘

Authorization

Requires a valid API Key in the Authorization header. Send the key directly — no Bearer prefix.

🔒

Ownership enforced

The query filters by user_id — calling with a playlist_id you do not own returns 400 "Playlist not found" (not 403, by design).

HTTP Method & Path

GET /playlists/{playlist_id}

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

Path Parameters

Response

Success Response (200)

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "user_id": "11111111-2222-3333-4444-555555555555",
  "name": "Onboarding Series",
  "description": "Internal onboarding for new hires.",
  "access_type": "anyone_with_password",
  "hide_views": false,
  "creator_name": "Panda Education",
  "external_button": { "text": "Open course", "url": "https://example.com/course", "size": "medium" },
  "image_id": "img_22222222-3333-4444-5555-666666666666",
  "duration": 4520,
  "videos_quantity": 6,
  "created_at": "2025-01-15T10:00:00.000Z",
  "updated_at": "2025-01-15T10:00:00.000Z",
  "image": {
    "cdn_base": "https://cdn.pandavideo.com.br",
    "storage_path": "images/playlist-logo.png"
  }
}

⚠️

Password stripped. The handler explicitly deletes password from the response before returning. Use the public Get playlist details with password endpoint to validate it instead.

Response Schema

Same fields as the playlist model + nested image: { cdn_base, storage_path } (when image_id is set, otherwise null). To build the full logo URL on the client: ${image.cdn_base}/${image.storage_path}.

Error Responses

• 400 — "Playlist not found" (playlist does not exist OR caller does not own it).
• 401 — missing/invalid API Key.
• 500 — internal error.

Example Usage

cURL

curl --request GET \
  --url 'https://api-v2.pandavideo.com.br/playlists/a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Authorization: <your-api-key>'

Recipes