Get a Show by id

v1.0.0

The response object represents the next occurence of the show specified by {id}.

Status 404 is returned if a show with {id} does not exist or if it does but all its scheduled occurences elapsed in the past.

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",
  "description": "A `Show` object describes one occurrence of a radio program. A result set may contain multiple occurrences of the same show with difference `start` and `end` values.",
  "properties": {
    "_links": {
      "type": "object",
      "properties": {
        "personas": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "href": {
                "type": "string"
              }
            }
          }
        },
        "playlists": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        },
        "self": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string"
            }
          }
        }
      }
    },
    "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"
    },
    "hide_dj": {
      "type": "boolean",
      "description": "Should the client application hide information about the show's DJs/hosts?"
    },
    "id": {
      "type": "integer"
    },
    "image": {
      "type": "string",
      "format": "url"
    },
    "one_off": {
      "type": "boolean",
      "description": "Is the show a one-off in the schedule instead of repeating?"
    },
    "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 program/show"
    }
  }
}