7digital · JSON Structure

Streaming Platform Playlist List Response Structure

PlaylistListResponse schema from 7digital API

Type: object Properties: 5
MusicStreamingLicensingCatalogueB2BRoyalty ReportingPublic APIs

PlaylistListResponse is a JSON Structure definition published by 7digital, describing 5 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

status page pageSize totalItems playlists

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "type": "object",
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/7digital/refs/heads/main/json-structure/streaming-platform-playlist-list-response-structure.json",
  "name": "PlaylistListResponse",
  "description": "PlaylistListResponse schema from 7digital API",
  "properties": {
    "status": {
      "type": "string",
      "example": "ok"
    },
    "page": {
      "type": "int32",
      "example": 1
    },
    "pageSize": {
      "type": "int32",
      "example": 20
    },
    "totalItems": {
      "type": "int32",
      "example": 12
    },
    "playlists": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "playlist-789012"
          },
          "name": {
            "type": "string",
            "example": "Morning Run"
          },
          "description": {
            "type": "string",
            "maxLength": 500,
            "example": "High-energy tracks for early-morning runs."
          },
          "visibility": {
            "type": "string",
            "enum": [
              "private",
              "public"
            ],
            "example": "public"
          },
          "userId": {
            "type": "string",
            "nullable": true,
            "example": "500123"
          },
          "trackCount": {
            "type": "int32",
            "example": 24
          },
          "tracks": {
            "type": "array",
            "items": {
              "allOf": [
                {
                  "type": "object",
                  "properties": {
                    "trackId": {
                      "type": "string",
                      "example": "123456"
                    },
                    "name": {
                      "type": "string",
                      "example": "Come Together"
                    },
                    "artist": {
                      "type": "string",
                      "example": "The Beatles"
                    },
                    "source": {
                      "type": "string",
                      "description": "Source for the physical file (defaults to `7digital`).",
                      "example": "7digital"
                    },
                    "audioUrl": {
                      "type": "uri",
                      "description": "Optional alternative source URL for the physical file.",
                      "example": "file://a.specific.file.location.mp3"
                    },
                    "image": {
                      "type": "uri",
                      "example": "https://artwork-cdn.7static.com/static/img/sleeveart/00/117/000/0011700062_350.jpg"
                    }
                  },
                  "required": [
                    "trackId",
                    "title",
                    "artist"
                  ]
                },
                {
                  "type": "object",
                  "properties": {
                    "position": {
                      "type": "int32",
                      "example": 1
                    },
                    "addedAt": {
                      "type": "datetime",
                      "example": "2026-05-28T14:30:00Z"
                    }
                  }
                }
              ]
            }
          },
          "createdAt": {
            "type": "datetime",
            "example": "2026-05-28T14:30:00Z"
          },
          "modifiedAt": {
            "type": "datetime",
            "example": "2026-05-28T15:00:00Z"
          }
        }
      }
    }
  }
}