action spinitron_get_shows_id {
  label: "Get a Show by id"
  description: "The response object represents the next occurence of the show specified by {id}.\n\nStatus 404 is returned if a show with {id} does not exist or if it does but all its scheduled occurences elapsed in the past.\n"
  provider: spinitron
  method: GET
  path: "/shows/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      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"
            additionalProperties: true
          }
          self: {
            type: "object"
            additionalProperties: true
          }
        }
      }
      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"
      }
    }
  }
}