Get playlist metadata

For video partners. Returns one playlist for your CMS: Category, group, title, description, artwork, and its clips in order with title, description, duration, muscle groups, equipment, difficulty, calories, poster and production order code. When your organisation is licensed for the playlist, it also says where your copies live in your media space. Call it when List playlists shows a content_version you have not stored.

GET /api/delivery/v1/playlists/{code}

Scope: metadata:read

Description#

Any playlist in the library can be read, licensed or not. When granted is true, media names your media space and the playlist in it, and each copied clip carries its video ID (vid) and format (hls or mp4). When granted is false, media is null and every clip has ready: false with no video ID. There are no playback links: your app plays the copies straight from your own media space.

A playlist that does not exist and one that is no longer in the library (withdrawn, or its Category withdrawn) return the same 404. A key of an organisation that licenses films gets 403 4032; use Get series metadata instead.

Successful responses are wrapped in the {code, message, data, server_time} envelope; errors use the same envelope without data, except 429 and 400 unsupported_version, which use the flat format. This endpoint shares its rate-limit counter with the catalog.

Request parameters#

Request example#

curl -s https://www.wandura.ai/api/delivery/v1/playlists/wall-pilates-01 \
  -H "Authorization: Bearer $WANDURA_API_KEY"

Response#

200 OK. New fields may be added at any time: ignore the ones you do not recognise.

Fields of a playlist (data)#

Images#

Each image (the playlist cover in images[], and each clip's poster) says in source where to get it. media_space: the image is already in your media space (space, uri); load it through your space as you load your videos. wandura_cdn: url is a link valid for 1 hour (until expires_at); download the file and host your own copy, never store the link. An image that is not available is null.

Response example#

{
  "code": 0,
  "message": "ok",
  "data": {
    "code": "wall-pilates-01",
    "status": "active",
    "title": "Wall Pilates",
    "description": "Ten low-impact moves using a wall for support.",
    "category": { "slug": "fitness", "name": "Fitness" },
    "group": { "code": "pilates", "title": "Pilates" },
    "updated_at": 1790390000,
    "content_version": "5d41402abc4b2a76b9719d911017c592",
    "metadata_version": "0cc175b9c0f1b6a831c399e269772661",
    "granted": true,
    "media": {
      "space": "your-fitness-space",
      "playlist_id": "9f8e7d6c5b4a3921",
      "playlist_name": "wall-pilates-01",
      "playlists": [{ "id": "9f8e7d6c5b4a3921", "name": "wall-pilates-01" }]
    },
    "images": [{ "kind": "cover", "source": "media_space", "url": null, "expires_at": null, "space": "your-fitness-space", "uri": "your-fitness-space/fit-3f2a1b4c.jpg" }],
    "clips": [
      {
        "position": 1,
        "id": "3f2a1b4c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
        "title": "Wall Squat",
        "description": "Slide down the wall and hold.",
        "duration_ms": 45000,
        "muscle_groups": ["quads", "glutes"],
        "equipment": ["wall"],
        "difficulty": "intermediate",
        "kcal_est": 9,
        "order_code": "ABS_01_E01",
        "poster": { "source": "media_space", "url": null, "expires_at": null, "space": "your-fitness-space", "uri": "your-fitness-space/fit-3f2a1b4c.jpg" },
        "ready": true,
        "vid": "v0a1b2c3d4e5f6",
        "format": "hls",
        "playlist_id": "9f8e7d6c5b4a3921",
        "playlist_name": "wall-pilates-01"
      }
    ]
  },
  "server_time": 1790400000
}

Response headers#

Errors#

What to do for each: Errors.