Get a Playlist by id

v1.0.0

The response object represents the playlist specified by {id}.

Status 404 is returned if a playlist with {id} does not exist or if it does but starts in the future (with allowed tolerance equals 1 hour in future).

Input

{
  "type": "object",
  "properties": {
    "expand": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "id": {
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "properties": {
    "_links": {
      "type": "object",
      "properties": {
        "persona": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        },
        "self": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        },
        "show": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        },
        "spins": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        }
      }
    },
    "automation": {
      "type": "boolean",
      "description": "Was the playlist created playlists created by a radio station automation system?"
    },
    "category": {
      "type": "string",
      "description": "Program/show category"
    },
    "description": {
      "type": "string",
      "description": "HTML-formatted description of the playlist or program/show"
    },
    "duration": {
      "type": "integer",
      "description": "Duration in seconds"
    },
    "end": {
      "type": "string",
      "format": "date-time",
      "description": "UTC datetime ISO-8601"
    },
    "episode_description": {
      "type": "string",
      "description": "HTML-formatted description of the episode"
    },
    "episode_name": {
      "type": "string",
      "description": "Title of this episode of the program/show"
    },
    "hide_dj": {
      "type": "boolean",
      "description": "Should the client application hide information about the playlist's DJ/host?"
    },
    "id": {
      "type": "integer"
    },
    "image": {
      "type": "string",
      "format": "url"
    },
    "persona_id": {
      "type": "integer"
    },
    "show_id": {
      "type": "integer"
    },
    "since": {
      "type": "integer",
      "format": "year",
      "description": "Since what year has the program/show existed?"
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "UTC datetime ISO-8601"
    },
    "timezone": {
      "type": "string",
      "description": "Station's time zone"
    },
    "title": {
      "type": "string",
      "description": "Program/show title"
    },
    "url": {
      "type": "string",
      "format": "url",
      "description": "URL to web site for the playlist or program/show"
    }
  }
}